| """ |
| PHP date() style date formatting |
| See http://www.php.net/date for format strings |
| |
| Usage: |
| >>> import datetime |
| >>> d = datetime.datetime.now() |
| >>> df = DateFormat(d) |
| >>> print df.format('jS F Y H:i') |
| 7th October 2003 11:39 |
| >>> |
| """ |
| |
| from django.utils.dates import MONTHS, MONTHS_3, MONTHS_AP, WEEKDAYS, WEEKDAYS_ABBR |
| from django.utils.tzinfo import LocalTimezone |
| from django.utils.translation import ugettext as _ |
| from django.utils.encoding import force_unicode |
| from calendar import isleap, monthrange |
| import re, time |
| |
| re_formatchars = re.compile(r'(?<!\\)([aAbBdDfFgGhHiIjlLmMnNOPrsStTUwWyYzZ])') |
| re_escaped = re.compile(r'\\(.)') |
| |
| class Formatter(object): |
| def format(self, formatstr): |
| pieces = [] |
| for i, piece in enumerate(re_formatchars.split(force_unicode(formatstr))): |
| if i % 2: |
| pieces.append(force_unicode(getattr(self, piece)())) |
| elif piece: |
| pieces.append(re_escaped.sub(r'\1', piece)) |
| return u''.join(pieces) |
| |
| class TimeFormat(Formatter): |
| def __init__(self, t): |
| self.data = t |
| |
| def a(self): |
| "'a.m.' or 'p.m.'" |
| if self.data.hour > 11: |
| return _('p.m.') |
| return _('a.m.') |
| |
| def A(self): |
| "'AM' or 'PM'" |
| if self.data.hour > 11: |
| return _('PM') |
| return _('AM') |
| |
| def B(self): |
| "Swatch Internet time" |
| raise NotImplementedError |
| |
| def f(self): |
| """ |
| Time, in 12-hour hours and minutes, with minutes left off if they're |
| zero. |
| Examples: '1', '1:30', '2:05', '2' |
| Proprietary extension. |
| """ |
| if self.data.minute == 0: |
| return self.g() |
| return u'%s:%s' % (self.g(), self.i()) |
| |
| def g(self): |
| "Hour, 12-hour format without leading zeros; i.e. '1' to '12'" |
| if self.data.hour == 0: |
| return 12 |
| if self.data.hour > 12: |
| return self.data.hour - 12 |
| return self.data.hour |
| |
| def G(self): |
| "Hour, 24-hour format without leading zeros; i.e. '0' to '23'" |
| return self.data.hour |
| |
| def h(self): |
| "Hour, 12-hour format; i.e. '01' to '12'" |
| return u'%02d' % self.g() |
| |
| def H(self): |
| "Hour, 24-hour format; i.e. '00' to '23'" |
| return u'%02d' % self.G() |
| |
| def i(self): |
| "Minutes; i.e. '00' to '59'" |
| return u'%02d' % self.data.minute |
| |
| def P(self): |
| """ |
| Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off |
| if they're zero and the strings 'midnight' and 'noon' if appropriate. |
| Examples: '1 a.m.', '1:30 p.m.', 'midnight', 'noon', '12:30 p.m.' |
| Proprietary extension. |
| """ |
| if self.data.minute == 0 and self.data.hour == 0: |
| return _('midnight') |
| if self.data.minute == 0 and self.data.hour == 12: |
| return _('noon') |
| return u'%s %s' % (self.f(), self.a()) |
| |
| def s(self): |
| "Seconds; i.e. '00' to '59'" |
| return u'%02d' % self.data.second |
| |
| class DateFormat(TimeFormat): |
| year_days = [None, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334] |
| |
| def __init__(self, dt): |
| # Accepts either a datetime or date object. |
| self.data = dt |
| self.timezone = getattr(dt, 'tzinfo', None) |
| if hasattr(self.data, 'hour') and not self.timezone: |
| self.timezone = LocalTimezone(dt) |
| |
| def b(self): |
| "Month, textual, 3 letters, lowercase; e.g. 'jan'" |
| return MONTHS_3[self.data.month] |
| |
| def d(self): |
| "Day of the month, 2 digits with leading zeros; i.e. '01' to '31'" |
| return u'%02d' % self.data.day |
| |
| def D(self): |
| "Day of the week, textual, 3 letters; e.g. 'Fri'" |
| return WEEKDAYS_ABBR[self.data.weekday()] |
| |
| def F(self): |
| "Month, textual, long; e.g. 'January'" |
| return MONTHS[self.data.month] |
| |
| def I(self): |
| "'1' if Daylight Savings Time, '0' otherwise." |
| if self.timezone.dst(self.data): |
| return u'1' |
| else: |
| return u'0' |
| |
| def j(self): |
| "Day of the month without leading zeros; i.e. '1' to '31'" |
| return self.data.day |
| |
| def l(self): |
| "Day of the week, textual, long; e.g. 'Friday'" |
| return WEEKDAYS[self.data.weekday()] |
| |
| def L(self): |
| "Boolean for whether it is a leap year; i.e. True or False" |
| return isleap(self.data.year) |
| |
| def m(self): |
| "Month; i.e. '01' to '12'" |
| return u'%02d' % self.data.month |
| |
| def M(self): |
| "Month, textual, 3 letters; e.g. 'Jan'" |
| return MONTHS_3[self.data.month].title() |
| |
| def n(self): |
| "Month without leading zeros; i.e. '1' to '12'" |
| return self.data.month |
| |
| def N(self): |
| "Month abbreviation in Associated Press style. Proprietary extension." |
| return MONTHS_AP[self.data.month] |
| |
| def O(self): |
| "Difference to Greenwich time in hours; e.g. '+0200'" |
| seconds = self.Z() |
| return u"%+03d%02d" % (seconds // 3600, (seconds // 60) % 60) |
| |
| def r(self): |
| "RFC 2822 formatted date; e.g. 'Thu, 21 Dec 2000 16:01:07 +0200'" |
| return self.format('D, j M Y H:i:s O') |
| |
| def S(self): |
| "English ordinal suffix for the day of the month, 2 characters; i.e. 'st', 'nd', 'rd' or 'th'" |
| if self.data.day in (11, 12, 13): # Special case |
| return u'th' |
| last = self.data.day % 10 |
| if last == 1: |
| return u'st' |
| if last == 2: |
| return u'nd' |
| if last == 3: |
| return u'rd' |
| return u'th' |
| |
| def t(self): |
| "Number of days in the given month; i.e. '28' to '31'" |
| return u'%02d' % monthrange(self.data.year, self.data.month)[1] |
| |
| def T(self): |
| "Time zone of this machine; e.g. 'EST' or 'MDT'" |
| name = self.timezone.tzname(self.data) |
| if name is None: |
| name = self.format('O') |
| return unicode(name) |
| |
| def U(self): |
| "Seconds since the Unix epoch (January 1 1970 00:00:00 GMT)" |
| off = self.timezone.utcoffset(self.data) |
| return int(time.mktime(self.data.timetuple())) + off.seconds * 60 |
| |
| def w(self): |
| "Day of the week, numeric, i.e. '0' (Sunday) to '6' (Saturday)" |
| return (self.data.weekday() + 1) % 7 |
| |
| def W(self): |
| "ISO-8601 week number of year, weeks starting on Monday" |
| # Algorithm from http://www.personal.ecu.edu/mccartyr/ISOwdALG.txt |
| week_number = None |
| jan1_weekday = self.data.replace(month=1, day=1).weekday() + 1 |
| weekday = self.data.weekday() + 1 |
| day_of_year = self.z() |
| if day_of_year <= (8 - jan1_weekday) and jan1_weekday > 4: |
| if jan1_weekday == 5 or (jan1_weekday == 6 and isleap(self.data.year-1)): |
| week_number = 53 |
| else: |
| week_number = 52 |
| else: |
| if isleap(self.data.year): |
| i = 366 |
| else: |
| i = 365 |
| if (i - day_of_year) < (4 - weekday): |
| week_number = 1 |
| else: |
| j = day_of_year + (7 - weekday) + (jan1_weekday - 1) |
| week_number = j // 7 |
| if jan1_weekday > 4: |
| week_number -= 1 |
| return week_number |
| |
| def y(self): |
| "Year, 2 digits; e.g. '99'" |
| return unicode(self.data.year)[2:] |
| |
| def Y(self): |
| "Year, 4 digits; e.g. '1999'" |
| return self.data.year |
| |
| def z(self): |
| "Day of the year; i.e. '0' to '365'" |
| doy = self.year_days[self.data.month] + self.data.day |
| if self.L() and self.data.month > 2: |
| doy += 1 |
| return doy |
| |
| def Z(self): |
| """ |
| Time zone offset in seconds (i.e. '-43200' to '43200'). The offset for |
| timezones west of UTC is always negative, and for those east of UTC is |
| always positive. |
| """ |
| offset = self.timezone.utcoffset(self.data) |
| # Only days can be negative, so negative offsets have days=-1 and |
| # seconds positive. Positive offsets have days=0 |
| return offset.days * 86400 + offset.seconds |
| |
| def format(value, format_string): |
| "Convenience function" |
| df = DateFormat(value) |
| return df.format(format_string) |
| |
| def time_format(value, format_string): |
| "Convenience function" |
| tf = TimeFormat(value) |
| return tf.format(format_string) |