mirror of
https://github.com/kennethreitz/maya.git
synced 2026-06-05 23:00:18 +00:00
159 lines
3.8 KiB
Python
159 lines
3.8 KiB
Python
|
|
# ___ __ ___ _ _ ___
|
|
# || \/ | ||=|| \\// ||=||
|
|
# || | || || // || ||
|
|
|
|
# Ignore warnings for yaml usage.
|
|
import warnings
|
|
import ruamel.yaml
|
|
warnings.simplefilter('ignore', ruamel.yaml.error.UnsafeLoaderWarning)
|
|
|
|
|
|
import email.utils
|
|
import time
|
|
from datetime import datetime as Datetime
|
|
|
|
import pytz
|
|
import humanize
|
|
import dateparser
|
|
import iso8601
|
|
import dateutil.parser
|
|
from tzlocal import get_localzone
|
|
|
|
EPOCH_START = (1970, 1, 1)
|
|
|
|
class MayaDT(object):
|
|
"""The Maya Datetime object."""
|
|
|
|
def __init__(self, epoch):
|
|
super(MayaDT, self).__init__()
|
|
self._epoch = epoch
|
|
|
|
def __repr__(self):
|
|
return '<MayaDT epoch={}>'.format(self._epoch)
|
|
|
|
def __format__(self, *args, **kwargs):
|
|
"""Return's the datetime's format"""
|
|
return self.datetime(*args, **kwargs)
|
|
|
|
@property
|
|
def local_timezone(self):
|
|
return self._local_tz.zone
|
|
|
|
@property
|
|
def _local_tz(self):
|
|
return get_localzone()
|
|
|
|
@staticmethod
|
|
def __dt_to_epoch(dt):
|
|
"""Converts a datetime into an epoch."""
|
|
epoch_start = Datetime(*EPOCH_START, tzinfo=pytz.timezone('UTC'))
|
|
return (dt - epoch_start).total_seconds()
|
|
|
|
@classmethod
|
|
def from_datetime(klass, dt):
|
|
"""Returns MayaDT instance from datetime."""
|
|
return klass(klass.__dt_to_epoch(dt))
|
|
|
|
@classmethod
|
|
def from_iso8601(klass, string):
|
|
"""Returns MayaDT instance from iso8601 string."""
|
|
dt = iso8601.parse_date(string)
|
|
return klass.from_datetime(dt)
|
|
|
|
@staticmethod
|
|
def from_rfc2822(string):
|
|
"""Returns MayaDT instance from rfc2822 string."""
|
|
return parse(string)
|
|
|
|
def datetime(self, to_timezone=None, naive=False):
|
|
"""Returns a timezone-aware datetime...
|
|
Defaulting to UTC (as it should).
|
|
|
|
Keyword Arguments:
|
|
to_timezone {string} -- timezone to convert to (default: {None/UTC})
|
|
"""
|
|
if to_timezone:
|
|
dt = self.datetime().astimezone(pytz.timezone(to_timezone))
|
|
else:
|
|
dt = Datetime.utcfromtimestamp(self._epoch)
|
|
|
|
# Strip the timezone info if requested to do so.
|
|
if naive:
|
|
return dt.replace(tzinfo=None)
|
|
|
|
return dt.replace(tzinfo=self._tz)
|
|
|
|
|
|
@property
|
|
def year(self):
|
|
return self.datetime().year
|
|
|
|
@property
|
|
def month(self):
|
|
return self.datetime().month
|
|
|
|
@property
|
|
def day(self):
|
|
return self.datetime().day
|
|
|
|
@property
|
|
def hour(self):
|
|
return self.datetime().hour
|
|
|
|
@property
|
|
def minute(self):
|
|
return self.datetime().minute
|
|
|
|
@property
|
|
def second(self):
|
|
return self.datetime().second
|
|
|
|
@property
|
|
def microsecond(self):
|
|
return self.datetime().microsecond
|
|
|
|
@property
|
|
def _tz(self):
|
|
return pytz.timezone(self.timezone)
|
|
|
|
@property
|
|
def timezone(self):
|
|
"""Timezone. Always UTC."""
|
|
return 'UTC'
|
|
|
|
def iso8601(self):
|
|
# Get a timezone-naive datetime.
|
|
dt = self.datetime(naive=True)
|
|
return '{}Z'.format(dt.isoformat())
|
|
|
|
def epoch(self):
|
|
return self._epoch
|
|
|
|
def slang_date(self):
|
|
return humanize.naturaldate(self.datetime())
|
|
|
|
def slang_time(self):
|
|
dt = self.datetime(naive=True, to_timezone=self.local_timezone)
|
|
return humanize.naturaltime(dt)
|
|
|
|
def rfc2822(self):
|
|
return email.utils.formatdate(self.epoch(), usegmt=True)
|
|
|
|
|
|
def now():
|
|
"""Returns MayaDT for right now."""
|
|
epoch = time.time()
|
|
return MayaDT(epoch=epoch)
|
|
|
|
def when(string, timezone='UTC'):
|
|
dt = dateparser.parse(string, settings={'TIMEZONE': timezone, 'RETURN_AS_TIMEZONE_AWARE': True, 'TO_TIMEZONE': 'UTC'})
|
|
|
|
if dt is None:
|
|
raise ValueError('invalid datetime input specified.')
|
|
|
|
return MayaDT.from_datetime(dt)
|
|
|
|
def parse(string):
|
|
dt = dateutil.parser.parse(string)
|
|
return MayaDT.from_datetime(dt) |