def testInitialize(self): """Tests the __init__ function.""" posix_epoch = posix_time.PosixTimeEpoch() self.assertIsNotNone(posix_epoch)
class FakeTime(interface.DateTimeValues):
"""Fake timestamp.
The fake timestamp is intended for testing purposes. On initialization
it contains the current time in UTC in microsecond precision.
Attributes:
is_local_time (bool): True if the date and time value is in local time.
"""
_EPOCH = posix_time.PosixTimeEpoch()
def __init__(self):
"""Initializes a fake timestamp."""
# Note that time.time() and divmod return floating point values.
timestamp, fraction_of_second = divmod(time.time(), 1)
super(FakeTime, self).__init__()
self._microseconds = int(fraction_of_second *
definitions.MICROSECONDS_PER_SECOND)
self._number_of_seconds = int(timestamp)
self._precision = definitions.PRECISION_1_MICROSECOND
def _GetNormalizedTimestamp(self):
"""Retrieves the normalized timestamp.
Returns:
decimal.Decimal: normalized timestamp, which contains the number of
seconds since January 1, 1970 00:00:00 and a fraction of second used
for increased precision, or None if the normalized timestamp cannot be
determined.
"""
if self._normalized_timestamp is None:
if self._number_of_seconds is not None:
self._normalized_timestamp = (
decimal.Decimal(self._microseconds) /
definitions.MICROSECONDS_PER_SECOND)
self._normalized_timestamp += decimal.Decimal(
self._number_of_seconds)
return self._normalized_timestamp
def CopyFromDateTimeString(self, time_string):
"""Copies a fake timestamp from a date and time string.
Args:
time_string (str): date and time value formatted as:
YYYY-MM-DD hh:mm:ss.######[+-]##:##
Where # are numeric digits ranging from 0 to 9 and the seconds
fraction can be either 3 or 6 digits. The time of day, seconds
fraction and time zone offset are optional. The default time zone
is UTC.
"""
date_time_values = self._CopyDateTimeFromString(time_string)
year = date_time_values.get('year', 0)
month = date_time_values.get('month', 0)
day_of_month = date_time_values.get('day_of_month', 0)
hours = date_time_values.get('hours', 0)
minutes = date_time_values.get('minutes', 0)
seconds = date_time_values.get('seconds', 0)
time_zone_offset = date_time_values.get('time_zone_offset', 0)
self._normalized_timestamp = None
self._number_of_seconds = self._GetNumberOfSecondsFromElements(
year, month, day_of_month, hours, minutes, seconds,
time_zone_offset)
self._microseconds = date_time_values.get('microseconds', None)
self._time_zone_offset = time_zone_offset
def CopyToDateTimeString(self):
"""Copies the fake timestamp to a date and time string.
Returns:
str: date and time value formatted as: "YYYY-MM-DD hh:mm:ss" or
"YYYY-MM-DD hh:mm:ss.######" or None if the number of seconds
is missing.
"""
if self._number_of_seconds is None:
return None
number_of_days, hours, minutes, seconds = self._GetTimeValues(
self._number_of_seconds)
year, month, day_of_month = self._GetDateValuesWithEpoch(
number_of_days, self._EPOCH)
if self._microseconds is None:
return '{0:04d}-{1:02d}-{2:02d} {3:02d}:{4:02d}:{5:02d}'.format(
year, month, day_of_month, hours, minutes, seconds)
return '{0:04d}-{1:02d}-{2:02d} {3:02d}:{4:02d}:{5:02d}.{6:06d}'.format(
year, month, day_of_month, hours, minutes, seconds,
self._microseconds)
class JavaTime(interface.DateTimeValues):
"""Java java.util.Date timestamp.
The Java java.util.Date timestamp is a signed integer that contains the
number of milliseconds since 1970-01-01 00:00:00 (also known as the POSIX
epoch). Negative values represent date and times predating the POSIX epoch.
Also see:
https://docs.oracle.com/javase/8/docs/api/java/util/Date.html
Attributes:
is_local_time (bool): True if the date and time value is in local time.
"""
_EPOCH = posix_time.PosixTimeEpoch()
def __init__(self, timestamp=None):
"""Initializes a Java timestamp.
Args:
timestamp (Optional[int]): Java timestamp.
"""
super(JavaTime, self).__init__()
self._precision = definitions.PRECISION_1_MILLISECOND
self._timestamp = timestamp
@property
def timestamp(self):
"""int: Java timestamp or None if timestamp is not set."""
return self._timestamp
def _GetNormalizedTimestamp(self):
"""Retrieves the normalized timestamp.
Returns:
decimal.Decimal: normalized timestamp, which contains the number of
seconds since January 1, 1970 00:00:00 and a fraction of second used
for increased precision, or None if the normalized timestamp cannot be
determined.
"""
if self._normalized_timestamp is None:
if (self._timestamp is not None
and self._timestamp >= self._INT64_MIN
and self._timestamp <= self._INT64_MAX):
self._normalized_timestamp = (
decimal.Decimal(self._timestamp) /
definitions.MILLISECONDS_PER_SECOND)
return self._normalized_timestamp
def CopyFromDateTimeString(self, time_string):
"""Copies a Java timestamp from a date and time string.
Args:
time_string (str): date and time value formatted as:
YYYY-MM-DD hh:mm:ss.######[+-]##:##
Where # are numeric digits ranging from 0 to 9 and the seconds
fraction can be either 3 or 6 digits. The time of day, seconds
fraction and time zone offset are optional. The default time zone
is UTC.
"""
date_time_values = self._CopyDateTimeFromString(time_string)
year = date_time_values.get('year', 0)
month = date_time_values.get('month', 0)
day_of_month = date_time_values.get('day_of_month', 0)
hours = date_time_values.get('hours', 0)
minutes = date_time_values.get('minutes', 0)
seconds = date_time_values.get('seconds', 0)
microseconds = date_time_values.get('microseconds', None)
timestamp = self._GetNumberOfSecondsFromElements(
year, month, day_of_month, hours, minutes, seconds)
timestamp *= definitions.MILLISECONDS_PER_SECOND
if microseconds:
milliseconds, _ = divmod(microseconds,
definitions.MILLISECONDS_PER_SECOND)
timestamp += milliseconds
self._normalized_timestamp = None
self._timestamp = timestamp
self.is_local_time = False
def CopyToDateTimeString(self):
"""Copies the Java timestamp to a date and time string.
Returns:
str: date and time value formatted as: "YYYY-MM-DD hh:mm:ss.###" or
None if the timestamp is missing or invalid.
"""
if (self._timestamp is None or self._timestamp < self._INT64_MIN
or self._timestamp > self._INT64_MAX):
return None
timestamp, milliseconds = divmod(self._timestamp,
definitions.MILLISECONDS_PER_SECOND)
number_of_days, hours, minutes, seconds = self._GetTimeValues(
timestamp)
year, month, day_of_month = self._GetDateValuesWithEpoch(
number_of_days, self._EPOCH)
return '{0:04d}-{1:02d}-{2:02d} {3:02d}:{4:02d}:{5:02d}.{6:03d}'.format(
year, month, day_of_month, hours, minutes, seconds, milliseconds)
def GetDate(self):
"""Retrieves the date represented by the date and time values.
Returns:
tuple[int, int, int]: year, month, day of month or (None, None, None)
if the date and time values do not represent a date.
"""
if (self.timestamp is None or self.timestamp < self._INT64_MIN
or self.timestamp > self._INT64_MAX):
return None, None, None
try:
timestamp, _ = divmod(self.timestamp,
definitions.MILLISECONDS_PER_SECOND)
number_of_days, _, _, _ = self._GetTimeValues(timestamp)
return self._GetDateValuesWithEpoch(number_of_days, self._EPOCH)
except ValueError:
return None, None, None