Mercurial > babel > old > babel-test
annotate babel/dates.py @ 15:76985c08a339
Minor date formatting improvements.
| author | cmlenz |
|---|---|
| date | Thu, 31 May 2007 14:20:04 +0000 |
| parents | a2c54ef107c2 |
| children | ed154241c08d |
| rev | line source |
|---|---|
| 1 | 1 # -*- coding: utf-8 -*- |
| 2 # | |
| 3 # Copyright (C) 2007 Edgewall Software | |
| 4 # All rights reserved. | |
| 5 # | |
| 6 # This software is licensed as described in the file COPYING, which | |
| 7 # you should have received as part of this distribution. The terms | |
| 8 # are also available at http://babel.edgewall.org/wiki/License. | |
| 9 # | |
| 10 # This software consists of voluntary contributions made by many | |
| 11 # individuals. For the exact contribution history, see the revision | |
| 12 # history and logs, available at http://babel.edgewall.org/log/. | |
| 13 | |
| 14 """Locale dependent formatting and parsing of dates and times. | |
| 15 | |
| 16 The default locale for the functions in this module is determined by the | |
| 17 following environment variables, in that order: | |
| 18 | |
| 19 * ``LC_TIME``, | |
| 20 * ``LC_ALL``, and | |
| 21 * ``LANG`` | |
| 22 """ | |
| 23 | |
| 24 from datetime import date, datetime, time | |
| 25 | |
| 26 from babel.core import Locale | |
| 27 from babel.util import default_locale | |
| 28 | |
| 29 __all__ = ['format_date', 'format_datetime', 'format_time', 'parse_date', | |
| 30 'parse_datetime', 'parse_time'] | |
| 31 __docformat__ = 'restructuredtext en' | |
| 32 | |
| 33 LC_TIME = default_locale('LC_TIME') | |
| 34 | |
| 35 def get_period_names(locale=LC_TIME): | |
| 36 """Return the names for day periods (AM/PM) used by the locale. | |
| 37 | |
| 38 >>> get_period_names(locale='en_US')['am'] | |
| 39 u'AM' | |
| 40 | |
| 41 :param locale: the `Locale` object, or a locale string | |
| 42 :return: the dictionary of period names | |
| 43 :rtype: `dict` | |
| 44 """ | |
| 45 return Locale.parse(locale).periods | |
| 46 | |
| 47 def get_day_names(width='wide', context='format', locale=LC_TIME): | |
| 48 """Return the day names used by the locale for the specified format. | |
| 49 | |
| 50 >>> get_day_names('wide', locale='en_US')[1] | |
| 15 | 51 u'Tuesday' |
| 1 | 52 >>> get_day_names('abbreviated', locale='es')[1] |
| 15 | 53 u'mar' |
| 1 | 54 >>> get_day_names('narrow', context='stand-alone', locale='de_DE')[1] |
| 15 | 55 u'D' |
| 1 | 56 |
| 57 :param width: the width to use, one of "wide", "abbreviated", or "narrow" | |
| 58 :param context: the context, either "format" or "stand-alone" | |
| 59 :param locale: the `Locale` object, or a locale string | |
| 60 :return: the dictionary of day names | |
| 61 :rtype: `dict` | |
| 62 """ | |
| 63 return Locale.parse(locale).days[context][width] | |
| 64 | |
| 65 def get_month_names(width='wide', context='format', locale=LC_TIME): | |
| 66 """Return the month names used by the locale for the specified format. | |
| 67 | |
| 68 >>> get_month_names('wide', locale='en_US')[1] | |
| 69 u'January' | |
| 70 >>> get_month_names('abbreviated', locale='es')[1] | |
| 71 u'ene' | |
| 72 >>> get_month_names('narrow', context='stand-alone', locale='de_DE')[1] | |
| 73 u'J' | |
| 74 | |
| 75 :param width: the width to use, one of "wide", "abbreviated", or "narrow" | |
| 76 :param context: the context, either "format" or "stand-alone" | |
| 77 :param locale: the `Locale` object, or a locale string | |
| 78 :return: the dictionary of month names | |
| 79 :rtype: `dict` | |
| 80 """ | |
| 81 return Locale.parse(locale).months[context][width] | |
| 82 | |
| 83 def get_quarter_names(width='wide', context='format', locale=LC_TIME): | |
| 84 """Return the quarter names used by the locale for the specified format. | |
| 85 | |
| 86 >>> get_quarter_names('wide', locale='en_US')[1] | |
| 87 u'1st quarter' | |
| 88 >>> get_quarter_names('abbreviated', locale='de_DE')[1] | |
| 89 u'Q1' | |
| 90 | |
| 91 :param width: the width to use, one of "wide", "abbreviated", or "narrow" | |
| 92 :param context: the context, either "format" or "stand-alone" | |
| 93 :param locale: the `Locale` object, or a locale string | |
| 94 :return: the dictionary of quarter names | |
| 95 :rtype: `dict` | |
| 96 """ | |
| 97 return Locale.parse(locale).quarters[context][width] | |
| 98 | |
| 99 def get_era_names(width='wide', locale=LC_TIME): | |
| 100 """Return the era names used by the locale for the specified format. | |
| 101 | |
| 102 >>> get_era_names('wide', locale='en_US')[1] | |
| 103 u'Anno Domini' | |
| 104 >>> get_era_names('abbreviated', locale='de_DE')[1] | |
| 105 u'n. Chr.' | |
| 106 | |
| 107 :param width: the width to use, either "wide" or "abbreviated" | |
| 108 :param locale: the `Locale` object, or a locale string | |
| 109 :return: the dictionary of era names | |
| 110 :rtype: `dict` | |
| 111 """ | |
| 112 return Locale.parse(locale).eras[width] | |
| 113 | |
| 114 def get_date_format(format='medium', locale=LC_TIME): | |
| 115 """Return the date formatting patterns used by the locale for the specified | |
| 116 format. | |
| 117 | |
| 118 >>> get_date_format(locale='en_US') | |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
119 <DateTimePattern u'MMM d, yyyy'> |
| 1 | 120 >>> get_date_format('full', locale='de_DE') |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
121 <DateTimePattern u'EEEE, d. MMMM yyyy'> |
| 1 | 122 |
| 123 :param format: the format to use, one of "full", "long", "medium", or | |
| 124 "short" | |
| 125 :param locale: the `Locale` object, or a locale string | |
| 126 :return: the date format pattern | |
| 127 :rtype: `dict` | |
| 128 """ | |
| 129 return Locale.parse(locale).date_formats[format] | |
| 130 | |
| 131 def get_time_format(format='medium', locale=LC_TIME): | |
| 132 """Return the time formatting patterns used by the locale for the specified | |
| 133 format. | |
| 134 | |
| 135 >>> get_time_format(locale='en_US') | |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
136 <DateTimePattern u'h:mm:ss a'> |
| 1 | 137 >>> get_time_format('full', locale='de_DE') |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
138 <DateTimePattern u"H:mm' Uhr 'z"> |
| 1 | 139 |
| 140 :param format: the format to use, one of "full", "long", "medium", or | |
| 141 "short" | |
| 142 :param locale: the `Locale` object, or a locale string | |
| 143 :return: the time format pattern | |
| 144 :rtype: `dict` | |
| 145 """ | |
| 146 return Locale.parse(locale).time_formats[format] | |
| 147 | |
| 148 def format_date(date, format='medium', locale=LC_TIME): | |
| 149 """Returns a date formatted according to the given pattern. | |
| 150 | |
| 151 >>> d = date(2007, 04, 01) | |
| 152 >>> format_date(d, locale='en_US') | |
| 153 u'Apr 1, 2007' | |
| 154 >>> format_date(d, format='full', locale='de_DE') | |
| 155 u'Sonntag, 1. April 2007' | |
| 156 | |
| 157 :param date: the ``date`` object | |
| 158 :param format: one of "full", "long", "medium", or "short" | |
| 159 :param locale: a `Locale` object or a locale string | |
| 160 :rtype: `unicode` | |
| 161 """ | |
| 162 locale = Locale.parse(locale) | |
| 163 if format in ('full', 'long', 'medium', 'short'): | |
| 164 format = get_date_format(format, locale=locale) | |
| 165 pattern = parse_pattern(format) | |
| 166 return parse_pattern(format).apply(date, locale) | |
| 167 | |
| 168 def format_datetime(datetime, format='medium', locale=LC_TIME): | |
| 169 """Returns a date formatted according to the given pattern. | |
| 170 | |
| 171 :param datetime: the ``date`` object | |
| 172 :param format: one of "full", "long", "medium", or "short" | |
| 173 :param locale: a `Locale` object or a locale string | |
| 174 :rtype: `unicode` | |
| 175 """ | |
| 176 raise NotImplementedError | |
| 177 | |
| 178 def format_time(time, format='medium', locale=LC_TIME): | |
| 179 """Returns a time formatted according to the given pattern. | |
| 180 | |
| 181 >>> t = time(15, 30) | |
| 182 >>> format_time(t, locale='en_US') | |
| 183 u'3:30:00 PM' | |
| 184 >>> format_time(t, format='short', locale='de_DE') | |
| 185 u'15:30' | |
| 186 | |
| 187 :param time: the ``time`` object | |
| 188 :param format: one of "full", "long", "medium", or "short" | |
| 189 :param locale: a `Locale` object or a locale string | |
| 190 :rtype: `unicode` | |
| 191 """ | |
| 192 locale = Locale.parse(locale) | |
| 193 if format in ('full', 'long', 'medium', 'short'): | |
| 194 format = get_time_format(format, locale=locale) | |
| 195 return parse_pattern(format).apply(time, locale) | |
| 196 | |
| 197 def parse_date(string, locale=LC_TIME): | |
| 198 raise NotImplementedError | |
| 199 | |
| 200 def parse_datetime(string, locale=LC_TIME): | |
| 201 raise NotImplementedError | |
| 202 | |
| 203 def parse_time(string, locale=LC_TIME): | |
| 204 raise NotImplementedError | |
| 205 | |
| 206 | |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
207 class DateTimePattern(object): |
| 1 | 208 |
| 209 def __init__(self, pattern, format): | |
| 210 self.pattern = pattern | |
| 211 self.format = format | |
| 212 | |
| 213 def __repr__(self): | |
| 214 return '<%s %r>' % (type(self).__name__, self.pattern) | |
| 215 | |
| 216 def __unicode__(self): | |
| 217 return self.pattern | |
| 218 | |
| 219 def __mod__(self, other): | |
| 220 assert type(other) is DateTimeFormat | |
| 221 return self.format % other | |
| 222 | |
| 223 def apply(self, datetime, locale): | |
| 224 return self % DateTimeFormat(datetime, locale) | |
| 225 | |
| 226 | |
| 227 class DateTimeFormat(object): | |
| 228 | |
| 229 def __init__(self, value, locale): | |
| 230 assert isinstance(value, (date, datetime, time)) | |
| 231 self.value = value | |
| 232 self.locale = Locale.parse(locale) | |
| 233 | |
| 234 def __getitem__(self, name): | |
| 235 # TODO: a number of fields missing here | |
| 15 | 236 char = name[0] |
| 237 num = len(name) | |
| 238 if char == 'G': | |
| 239 return self.format_era(char, num) | |
| 240 elif char in ('y', 'Y'): | |
| 241 return self.format_year(char, num) | |
| 242 elif char in ('Q', 'q'): | |
| 243 return self.format_quarter(char, num) | |
| 244 elif char in ('M', 'L'): | |
| 245 return self.format_month(char, num) | |
| 246 elif char == 'd': | |
| 247 return self.format(self.value.day, num) | |
| 248 elif char in ('E', 'e', 'c'): | |
| 249 return self.format_weekday(char, num) | |
| 250 elif char == 'a': | |
| 251 return self.format_period(char) | |
| 252 elif char == 'h': | |
| 253 return self.format(self.value.hour % 12, num) | |
| 254 elif char == 'H': | |
| 255 return self.format(self.value.hour, num) | |
| 256 elif char == 'm': | |
| 257 return self.format(self.value.minute, num) | |
| 258 elif char == 's': | |
| 259 return self.format(self.value.second, num) | |
| 1 | 260 else: |
| 15 | 261 raise KeyError('Unsupported date/time field %r' % char) |
| 1 | 262 |
| 15 | 263 def format_era(self, char, num): |
| 1 | 264 width = {3: 'abbreviated', 4: 'wide', 5: 'narrow'}[max(3, num)] |
| 265 era = int(self.value.year >= 0) | |
| 266 return get_era_names(width, self.locale)[era] | |
| 267 | |
| 15 | 268 def format_year(self, char, num): |
| 269 if char.islower(): | |
| 270 value = self.value.year | |
| 271 else: | |
| 272 value = self.value.isocalendar()[0] | |
| 1 | 273 year = self.format(value, num) |
| 274 if num == 2: | |
| 275 year = year[-2:] | |
| 276 return year | |
| 277 | |
| 15 | 278 def format_month(self, char, num): |
| 1 | 279 if num <= 2: |
| 280 return ('%%0%dd' % num) % self.value.month | |
| 281 width = {3: 'abbreviated', 4: 'wide', 5: 'narrow'}[num] | |
| 15 | 282 context = {3: 'format', 4: 'format', 5: 'stand-alone'}[num] |
| 1 | 283 return get_month_names(width, context, self.locale)[self.value.month] |
| 284 | |
| 15 | 285 def format_weekday(self, char, num): |
| 286 if num < 3: | |
| 287 if char.islower(): | |
| 288 value = 7 - self.locale.first_week_day + self.value.weekday() | |
| 289 return self.format(value % 7 + 1, num) | |
| 290 num = 3 | |
| 291 weekday = self.value.weekday() | |
| 292 width = {3: 'abbreviated', 4: 'wide', 5: 'narrow'}[num] | |
| 293 context = {3: 'format', 4: 'format', 5: 'stand-alone'}[num] | |
| 1 | 294 return get_day_names(width, context, self.locale)[weekday] |
| 295 | |
| 15 | 296 def format_period(self, char): |
| 1 | 297 period = {0: 'am', 1: 'pm'}[int(self.value.hour > 12)] |
| 298 return get_period_names(locale=self.locale)[period] | |
| 299 | |
| 300 def format(self, value, length): | |
| 301 return ('%%0%dd' % length) % value | |
| 302 | |
| 303 | |
| 304 PATTERN_CHARS = { | |
| 15 | 305 'G': [1, 2, 3, 4, 5], # era |
| 306 'y': None, 'Y': None, 'u': None, # year | |
| 307 'Q': [1, 2, 3, 4], 'q': [1, 2, 3, 4], # quarter | |
| 308 'M': [1, 2, 3, 4, 5], 'L': [1, 2, 3, 4, 5], # month | |
| 309 'w': [1, 2], 'W': [1], # week | |
| 310 'd': [1, 2], 'D': [1, 2, 3], 'F': [1], 'g': None, # day | |
| 311 'E': [1, 2, 3, 4, 5], 'e': [1, 2, 3, 4, 5], 'c': [1, 3, 4, 5], # week day | |
| 312 'a': [1], # period | |
| 313 'h': [1, 2], 'H': [1, 2], 'K': [1, 2], 'k': [1, 2], # hour | |
| 314 'm': [1, 2], # minute | |
| 315 's': [1, 2], 'S': None, 'A': None, # second | |
| 316 'z': [1, 2, 3, 4], 'Z': [1, 2, 3, 4], 'v': [1, 4] # zone | |
| 1 | 317 } |
| 318 | |
| 319 def parse_pattern(pattern): | |
| 320 """Parse date, time, and datetime format patterns. | |
| 321 | |
| 322 >>> parse_pattern("MMMMd").format | |
| 323 u'%(MMMM)s%(d)s' | |
| 324 >>> parse_pattern("MMM d, yyyy").format | |
| 325 u'%(MMM)s %(d)s, %(yyyy)s' | |
| 326 >>> parse_pattern("H:mm' Uhr 'z").format | |
| 327 u'%(H)s:%(mm)s Uhr %(z)s' | |
| 328 | |
| 329 :param pattern: the formatting pattern to parse | |
| 330 """ | |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
331 if type(pattern) is DateTimePattern: |
| 1 | 332 return pattern |
| 333 | |
| 334 result = [] | |
| 335 quotebuf = None | |
| 336 charbuf = [] | |
| 337 fieldchar = [''] | |
| 338 fieldnum = [0] | |
| 339 | |
| 340 def append_chars(): | |
| 341 result.append(''.join(charbuf).replace('%', '%%')) | |
| 342 del charbuf[:] | |
| 343 | |
| 344 def append_field(): | |
| 345 limit = PATTERN_CHARS[fieldchar[0]] | |
| 15 | 346 if limit and fieldnum[0] not in limit: |
| 1 | 347 raise ValueError('Invalid length for field: %r' |
| 348 % (fieldchar[0] * fieldnum[0])) | |
| 349 result.append('%%(%s)s' % (fieldchar[0] * fieldnum[0])) | |
| 350 fieldchar[0] = '' | |
| 351 fieldnum[0] = 0 | |
| 352 | |
| 353 for idx, char in enumerate(pattern): | |
| 354 if quotebuf is None: | |
| 355 if char == "'": # quote started | |
| 356 if fieldchar[0]: | |
| 357 append_field() | |
| 358 elif charbuf: | |
| 359 append_chars() | |
| 360 quotebuf = [] | |
| 361 elif char in PATTERN_CHARS: | |
| 362 if charbuf: | |
| 363 append_chars() | |
| 364 if char == fieldchar[0]: | |
| 365 fieldnum[0] += 1 | |
| 366 else: | |
| 367 if fieldchar[0]: | |
| 368 append_field() | |
| 369 fieldchar[0] = char | |
| 370 fieldnum[0] = 1 | |
| 371 else: | |
| 372 if fieldchar[0]: | |
| 373 append_field() | |
| 374 charbuf.append(char) | |
| 375 | |
| 376 elif quotebuf is not None: | |
| 377 if char == "'": # quote ended | |
| 378 charbuf.extend(quotebuf) | |
| 379 quotebuf = None | |
| 380 else: # inside quote | |
| 381 quotebuf.append(char) | |
| 382 | |
| 383 if fieldchar[0]: | |
| 384 append_field() | |
| 385 elif charbuf: | |
| 386 append_chars() | |
| 387 | |
|
12
a2c54ef107c2
* Removed pkg_resources/setuptools requirement from various places.
cmlenz
parents:
8
diff
changeset
|
388 return DateTimePattern(pattern, u''.join(result)) |