1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
# -*- coding: utf-8 -*-
"""WebKit timestamp implementation."""
from dfdatetime import definitions
from dfdatetime import interface
class WebKitTime(interface.DateTimeValues):
"""Class that implements a WebKit timestamp.
The WebKit timestamp is a signed 64-bit integer that contains the number of
micro seconds since 1601-01-01 00:00:00.
Attributes:
is_local_time (bool): True if the date and time value is in local time.
precision (str): precision of the date and time value, which should
be one of the PRECISION_VALUES in definitions.
"""
# The difference between Jan 1, 1601 and Jan 1, 1970 in seconds.
_WEBKIT_TO_POSIX_BASE = 11644473600
_INT64_MIN = -(1 << 63)
_INT64_MAX = (1 << 63) - 1
def __init__(self, timestamp=None):
"""Initializes a WebKit timestamp.
Args:
timestamp (Optional[int]): WebKit timestamp.
"""
super(WebKitTime, self).__init__()
self.precision = definitions.PRECISION_1_MICROSECOND
self.timestamp = timestamp
def CopyFromString(self, time_string):
"""Copies a WebKit timestamp from a string containing a date and time value.
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.
Raises:
ValueError: if the time string is invalid or not supported.
"""
date_time_values = self._CopyDateTimeFromString(time_string)
year = date_time_values.get(u'year', 0)
month = date_time_values.get(u'month', 0)
day_of_month = date_time_values.get(u'day_of_month', 0)
hours = date_time_values.get(u'hours', 0)
minutes = date_time_values.get(u'minutes', 0)
seconds = date_time_values.get(u'seconds', 0)
self.timestamp = self._GetNumberOfSecondsFromElements(
year, month, day_of_month, hours, minutes, seconds)
self.timestamp += self._WEBKIT_TO_POSIX_BASE
self.timestamp *= 1000000
self.timestamp += date_time_values.get(u'microseconds', 0)
self.is_local_time = False
def CopyToStatTimeTuple(self):
"""Copies the WebKit timestamp to a stat timestamp tuple.
Returns:
tuple[int, int]: a POSIX timestamp in seconds and the remainder in
100 nano seconds or (None, None) on error.
"""
if (self.timestamp is None or self.timestamp < self._INT64_MIN or
self.timestamp > self._INT64_MAX):
return None, None
timestamp, microseconds = divmod(self.timestamp, 1000000)
timestamp -= self._WEBKIT_TO_POSIX_BASE
return timestamp, microseconds * 10
def GetPlasoTimestamp(self):
"""Retrieves a timestamp that is compatible with plaso.
Returns:
int: a POSIX timestamp in microseconds or None on error.
"""
if (self.timestamp is None or self.timestamp < self._INT64_MIN or
self.timestamp > self._INT64_MAX):
return
return self.timestamp - (self._WEBKIT_TO_POSIX_BASE * 1000000)
|
