Loading [MathJax]/extensions/tex2jax.js
LSST Applications g04a91732dc+cc8870d3f5,g07dc498a13+5aa0b8792f,g0fba68d861+80045be308,g1409bbee79+5aa0b8792f,g1a7e361dbc+5aa0b8792f,g1fd858c14a+f64bc332a9,g208c678f98+1ae86710ed,g35bb328faa+fcb1d3bbc8,g4d2262a081+47ad8a29a8,g4d39ba7253+9633a327c1,g4e0f332c67+5d362be553,g53246c7159+fcb1d3bbc8,g60b5630c4e+9633a327c1,g668ecb457e+25d63fd678,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g7b71ed6315+fcb1d3bbc8,g8852436030+8b64ca622a,g89139ef638+5aa0b8792f,g89e1512fd8+04325574d3,g8d6b6b353c+9633a327c1,g9125e01d80+fcb1d3bbc8,g989de1cb63+5aa0b8792f,g9f33ca652e+b196626af7,ga9baa6287d+9633a327c1,gaaedd4e678+5aa0b8792f,gabe3b4be73+1e0a283bba,gb1101e3267+71e32094df,gb58c049af0+f03b321e39,gb90eeb9370+2807b1ad02,gcf25f946ba+8b64ca622a,gd315a588df+a39986a76f,gd6cbbdb0b4+c8606af20c,gd9a9a58781+fcb1d3bbc8,gde0f65d7ad+4e42d81ab7,ge278dab8ac+932305ba37,ge82c20c137+76d20ab76d,gfe73954cf8+a1301e4c20,w.2025.11
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
dateTimeContinued.py
Go to the documentation of this file.
2# LSST Data Management System
3#
4# Copyright 2008-2017 AURA/LSST.
5#
6# This product includes software developed by the
7# LSST Project (http://www.lsst.org/).
8#
9# This program is free software: you can redistribute it and/or modify
10# it under the terms of the GNU General Public License as published by
11# the Free Software Foundation, either version 3 of the License, or
12# (at your option) any later version.
13#
14# This program is distributed in the hope that it will be useful,
15# but WITHOUT ANY WARRANTY; without even the implied warranty of
16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17# GNU General Public License for more details.
18#
19# You should have received a copy of the LSST License Statement and
20# the GNU General Public License along with this program. If not,
21# see <http://www.lsstcorp.org/LegalNotices/>.
22
23__all__ = ["DateTime"]
24
25from lsst.utils import continueClass
26
27from .._dafBaseLib import DateTime
28
29
30@continueClass # noqa: F811 (FIXME: remove for py 3.8+)
31class DateTime: # noqa: F811
32
33 def toPython(self, timescale=None):
34 """Convert a DateTime to Python's datetime
35
36 Parameters
37 ----------
38 timescale : `dateTime.DateTime.Timescale`, optional
39 Timescale for resultant datetime.
40
41 Returns
42 -------
43 datetime : `datetime.datetime`
44 The resultant Python `datetime.datetime` object.
45
46 Raises
47 ------
48 ValueError
49 Raised if the DateTime is invalid (uninitialized).
50 """
51 import datetime
52 if not self.isValid():
53 raise RuntimeError("DateTime not valid")
54 nsecs = self.nsecs(timescale) if timescale is not None else self.nsecs()
55 return datetime.datetime.utcfromtimestamp(nsecs/10**9)
56
57 def toAstropy(self, timescale=None):
58 """Convert a DateTime to an astropy Time.
59
60 Returns
61 -------
62 time : `astropy.time.Time`
63 This date as an astropy MJD/TAI time.
64
65 Raises
66 ------
67 ValueError
68 Raised if the DateTime is invalid (uninitialized).
69 """
70 # So that astropy is not an import-time dependency of daf_base.
71 import astropy.time
72 return astropy.time.Time(self.get(system=DateTime.MJD, scale=DateTime.TAI), scale="tai", format="mjd")
73
74 def __repr__(self):
75 if self.isValid():
76 return "DateTime(\"{}\", TAI)".format(self.toString(DateTime.TAI))
77 else:
78 return "DateTime()"
79
80 def __reduce__(self):
81 return (DateTime, (self.nsecs(), ))
82
83 def __lt__(self, other):
84 if not isinstance(other, type(self)):
85 return NotImplemented
86 # Invalid date has very negative nsecs().
87 return self.nsecs() < other.nsecs()