web/lib/django/utils/dateformat.py
author ymh <ymh.work@gmail.com>
Wed, 02 Jun 2010 18:57:35 +0200
changeset 38 77b6da96e6f1
permissions -rw-r--r--
update django
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
38
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     1
"""
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     2
PHP date() style date formatting
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
See http://www.php.net/date for format strings
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     4
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     5
Usage:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     6
>>> import datetime
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     7
>>> d = datetime.datetime.now()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     8
>>> df = DateFormat(d)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
     9
>>> print df.format('jS F Y H:i')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    10
7th October 2003 11:39
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    11
>>>
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    12
"""
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    13
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    14
import re
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    15
import time
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    16
import calendar
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    17
from django.utils.dates import MONTHS, MONTHS_3, MONTHS_AP, WEEKDAYS, WEEKDAYS_ABBR
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    18
from django.utils.tzinfo import LocalTimezone
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    19
from django.utils.translation import ugettext as _
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    20
from django.utils.encoding import force_unicode
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    21
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    22
re_formatchars = re.compile(r'(?<!\\)([aAbBcdDfFgGhHiIjlLmMnNOPrsStTUuwWyYzZ])')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    23
re_escaped = re.compile(r'\\(.)')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    24
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    25
class Formatter(object):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
    def format(self, formatstr):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
        pieces = []
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    28
        for i, piece in enumerate(re_formatchars.split(force_unicode(formatstr))):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    29
            if i % 2:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
                pieces.append(force_unicode(getattr(self, piece)()))
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
            elif piece:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    32
                pieces.append(re_escaped.sub(r'\1', piece))
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
        return u''.join(pieces)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
class TimeFormat(Formatter):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
    def __init__(self, t):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
        self.data = t
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    39
    def a(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    40
        "'a.m.' or 'p.m.'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    41
        if self.data.hour > 11:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
            return _('p.m.')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    43
        return _('a.m.')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    44
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    45
    def A(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
        "'AM' or 'PM'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    47
        if self.data.hour > 11:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
            return _('PM')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    49
        return _('AM')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    51
    def B(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
        "Swatch Internet time"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    53
        raise NotImplementedError
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
    def f(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    57
        Time, in 12-hour hours and minutes, with minutes left off if they're
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
        zero.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
        Examples: '1', '1:30', '2:05', '2'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
        Proprietary extension.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    62
        if self.data.minute == 0:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
            return self.g()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
        return u'%s:%s' % (self.g(), self.i())
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
    def g(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
        "Hour, 12-hour format without leading zeros; i.e. '1' to '12'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
        if self.data.hour == 0:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
            return 12
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
        if self.data.hour > 12:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
            return self.data.hour - 12
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
        return self.data.hour
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
    def G(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    75
        "Hour, 24-hour format without leading zeros; i.e. '0' to '23'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
        return self.data.hour
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    77
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    78
    def h(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
        "Hour, 12-hour format; i.e. '01' to '12'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
        return u'%02d' % self.g()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    81
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
    def H(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
        "Hour, 24-hour format; i.e. '00' to '23'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    84
        return u'%02d' % self.G()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
    def i(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    87
        "Minutes; i.e. '00' to '59'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
        return u'%02d' % self.data.minute
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    89
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    90
    def P(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    91
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    92
        Time, in 12-hour hours, minutes and 'a.m.'/'p.m.', with minutes left off
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    93
        if they're zero and the strings 'midnight' and 'noon' if appropriate.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    94
        Examples: '1 a.m.', '1:30 p.m.', 'midnight', 'noon', '12:30 p.m.'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    95
        Proprietary extension.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    96
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    97
        if self.data.minute == 0 and self.data.hour == 0:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    98
            return _('midnight')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
    99
        if self.data.minute == 0 and self.data.hour == 12:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   100
            return _('noon')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   101
        return u'%s %s' % (self.f(), self.a())
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   102
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   103
    def s(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   104
        "Seconds; i.e. '00' to '59'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   105
        return u'%02d' % self.data.second
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
    def u(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
        "Microseconds"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
        return self.data.microsecond
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112
class DateFormat(TimeFormat):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   113
    year_days = [None, 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   114
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   115
    def __init__(self, dt):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   116
        # Accepts either a datetime or date object.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   117
        self.data = dt
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   118
        self.timezone = getattr(dt, 'tzinfo', None)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   119
        if hasattr(self.data, 'hour') and not self.timezone:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   120
            self.timezone = LocalTimezone(dt)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   121
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   122
    def b(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   123
        "Month, textual, 3 letters, lowercase; e.g. 'jan'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   124
        return MONTHS_3[self.data.month]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   125
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   126
    def c(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   127
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   128
        ISO 8601 Format
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   129
        Example : '2008-01-02T10:30:00.000123'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   130
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   131
        return self.data.isoformat()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   132
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   133
    def d(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   134
        "Day of the month, 2 digits with leading zeros; i.e. '01' to '31'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   135
        return u'%02d' % self.data.day
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   136
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   137
    def D(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   138
        "Day of the week, textual, 3 letters; e.g. 'Fri'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   139
        return WEEKDAYS_ABBR[self.data.weekday()]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   140
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   141
    def F(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   142
        "Month, textual, long; e.g. 'January'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   143
        return MONTHS[self.data.month]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   144
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   145
    def I(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   146
        "'1' if Daylight Savings Time, '0' otherwise."
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   147
        if self.timezone and self.timezone.dst(self.data):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   148
            return u'1'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   149
        else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   150
            return u'0'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   151
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   152
    def j(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   153
        "Day of the month without leading zeros; i.e. '1' to '31'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   154
        return self.data.day
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   155
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   156
    def l(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   157
        "Day of the week, textual, long; e.g. 'Friday'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   158
        return WEEKDAYS[self.data.weekday()]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   159
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   160
    def L(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   161
        "Boolean for whether it is a leap year; i.e. True or False"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   162
        return calendar.isleap(self.data.year)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   163
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   164
    def m(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   165
        "Month; i.e. '01' to '12'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   166
        return u'%02d' % self.data.month
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   167
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   168
    def M(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   169
        "Month, textual, 3 letters; e.g. 'Jan'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   170
        return MONTHS_3[self.data.month].title()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   171
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   172
    def n(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   173
        "Month without leading zeros; i.e. '1' to '12'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   174
        return self.data.month
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   175
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   176
    def N(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   177
        "Month abbreviation in Associated Press style. Proprietary extension."
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   178
        return MONTHS_AP[self.data.month]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   179
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   180
    def O(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   181
        "Difference to Greenwich time in hours; e.g. '+0200'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   182
        seconds = self.Z()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   183
        return u"%+03d%02d" % (seconds // 3600, (seconds // 60) % 60)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   184
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   185
    def r(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   186
        "RFC 2822 formatted date; e.g. 'Thu, 21 Dec 2000 16:01:07 +0200'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   187
        return self.format('D, j M Y H:i:s O')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   188
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   189
    def S(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   190
        "English ordinal suffix for the day of the month, 2 characters; i.e. 'st', 'nd', 'rd' or 'th'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   191
        if self.data.day in (11, 12, 13): # Special case
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   192
            return u'th'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   193
        last = self.data.day % 10
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   194
        if last == 1:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   195
            return u'st'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   196
        if last == 2:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   197
            return u'nd'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   198
        if last == 3:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   199
            return u'rd'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   200
        return u'th'
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   201
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   202
    def t(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   203
        "Number of days in the given month; i.e. '28' to '31'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   204
        return u'%02d' % calendar.monthrange(self.data.year, self.data.month)[1]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   205
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   206
    def T(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   207
        "Time zone of this machine; e.g. 'EST' or 'MDT'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   208
        name = self.timezone and self.timezone.tzname(self.data) or None
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   209
        if name is None:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   210
            name = self.format('O')
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   211
        return unicode(name)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   212
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   213
    def U(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   214
        "Seconds since the Unix epoch (January 1 1970 00:00:00 GMT)"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   215
        if getattr(self.data, 'tzinfo', None):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   216
            return int(calendar.timegm(self.data.utctimetuple()))
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   217
        else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   218
            return int(time.mktime(self.data.timetuple()))
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   219
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   220
    def w(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   221
        "Day of the week, numeric, i.e. '0' (Sunday) to '6' (Saturday)"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   222
        return (self.data.weekday() + 1) % 7
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   223
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   224
    def W(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   225
        "ISO-8601 week number of year, weeks starting on Monday"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   226
        # Algorithm from http://www.personal.ecu.edu/mccartyr/ISOwdALG.txt
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   227
        week_number = None
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   228
        jan1_weekday = self.data.replace(month=1, day=1).weekday() + 1
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   229
        weekday = self.data.weekday() + 1
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   230
        day_of_year = self.z()
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   231
        if day_of_year <= (8 - jan1_weekday) and jan1_weekday > 4:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   232
            if jan1_weekday == 5 or (jan1_weekday == 6 and calendar.isleap(self.data.year-1)):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   233
                week_number = 53
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   234
            else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   235
                week_number = 52
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   236
        else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   237
            if calendar.isleap(self.data.year):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   238
                i = 366
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   239
            else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   240
                i = 365
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   241
            if (i - day_of_year) < (4 - weekday):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   242
                week_number = 1
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   243
            else:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   244
                j = day_of_year + (7 - weekday) + (jan1_weekday - 1)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   245
                week_number = j // 7
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   246
                if jan1_weekday > 4:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   247
                    week_number -= 1
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   248
        return week_number
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   249
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   250
    def y(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   251
        "Year, 2 digits; e.g. '99'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   252
        return unicode(self.data.year)[2:]
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   253
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   254
    def Y(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   255
        "Year, 4 digits; e.g. '1999'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   256
        return self.data.year
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   257
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   258
    def z(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   259
        "Day of the year; i.e. '0' to '365'"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   260
        doy = self.year_days[self.data.month] + self.data.day
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   261
        if self.L() and self.data.month > 2:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   262
            doy += 1
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   263
        return doy
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   264
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   265
    def Z(self):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   266
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   267
        Time zone offset in seconds (i.e. '-43200' to '43200'). The offset for
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   268
        timezones west of UTC is always negative, and for those east of UTC is
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   269
        always positive.
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   270
        """
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   271
        if not self.timezone:
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   272
            return 0
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   273
        offset = self.timezone.utcoffset(self.data)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   274
        # Only days can be negative, so negative offsets have days=-1 and
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   275
        # seconds positive. Positive offsets have days=0
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   276
        return offset.days * 86400 + offset.seconds
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   277
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   278
def format(value, format_string):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   279
    "Convenience function"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   280
    df = DateFormat(value)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   281
    return df.format(format_string)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   282
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   283
def time_format(value, format_string):
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   284
    "Convenience function"
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   285
    tf = TimeFormat(value)
77b6da96e6f1 update django
ymh <ymh.work@gmail.com>
parents:
diff changeset
   286
    return tf.format(format_string)