OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // Basic time formatting methods. These methods use the current locale | 5 // Basic time formatting methods. These methods use the current locale |
6 // formatting for displaying the time. | 6 // formatting for displaying the time. |
7 | 7 |
8 #ifndef BASE_I18N_TIME_FORMATTING_H_ | 8 #ifndef BASE_I18N_TIME_FORMATTING_H_ |
9 #define BASE_I18N_TIME_FORMATTING_H_ | 9 #define BASE_I18N_TIME_FORMATTING_H_ |
10 | 10 |
(...skipping 19 matching lines...) Expand all Loading... |
30 | 30 |
31 // Should match UMeasureFormatWidth in measfmt.h; replicated here to avoid | 31 // Should match UMeasureFormatWidth in measfmt.h; replicated here to avoid |
32 // requiring third_party/icu dependencies with this file. | 32 // requiring third_party/icu dependencies with this file. |
33 enum DurationFormatWidth { | 33 enum DurationFormatWidth { |
34 DURATION_WIDTH_WIDE, // "3 hours, 7 minutes" | 34 DURATION_WIDTH_WIDE, // "3 hours, 7 minutes" |
35 DURATION_WIDTH_SHORT, // "3 hr, 7 min" | 35 DURATION_WIDTH_SHORT, // "3 hr, 7 min" |
36 DURATION_WIDTH_NARROW, // "3h 7m" | 36 DURATION_WIDTH_NARROW, // "3h 7m" |
37 DURATION_WIDTH_NUMERIC // "3:07" | 37 DURATION_WIDTH_NUMERIC // "3:07" |
38 }; | 38 }; |
39 | 39 |
| 40 // Date formats from third_party/icu/source/i18n/unicode/udat.h. Add more as |
| 41 // necessary. |
| 42 enum DateFormat { |
| 43 // November 2007 |
| 44 DATE_FORMAT_YEAR_MONTH, |
| 45 // Tuesday, 7 November |
| 46 DATE_FORMAT_MONTH_WEEKDAY_DAY, |
| 47 }; |
| 48 |
40 // Returns the time of day, e.g., "3:07 PM". | 49 // Returns the time of day, e.g., "3:07 PM". |
41 BASE_I18N_EXPORT string16 TimeFormatTimeOfDay(const Time& time); | 50 BASE_I18N_EXPORT string16 TimeFormatTimeOfDay(const Time& time); |
42 | 51 |
43 // Returns the time of day in 24-hour clock format with millisecond accuracy, | 52 // Returns the time of day in 24-hour clock format with millisecond accuracy, |
44 // e.g., "15:07:30.568" | 53 // e.g., "15:07:30.568" |
45 BASE_I18N_EXPORT string16 TimeFormatTimeOfDayWithMilliseconds(const Time& time); | 54 BASE_I18N_EXPORT string16 TimeFormatTimeOfDayWithMilliseconds(const Time& time); |
46 | 55 |
47 // Returns the time of day in the specified hour clock type. e.g. | 56 // Returns the time of day in the specified hour clock type. e.g. |
48 // "3:07 PM" (type == k12HourClock, ampm == kKeepAmPm). | 57 // "3:07 PM" (type == k12HourClock, ampm == kKeepAmPm). |
49 // "3:07" (type == k12HourClock, ampm == kDropAmPm). | 58 // "3:07" (type == k12HourClock, ampm == kDropAmPm). |
50 // "15:07" (type == k24HourClock). | 59 // "15:07" (type == k24HourClock). |
51 BASE_I18N_EXPORT string16 TimeFormatTimeOfDayWithHourClockType( | 60 BASE_I18N_EXPORT string16 TimeFormatTimeOfDayWithHourClockType( |
52 const Time& time, | 61 const Time& time, |
53 HourClockType type, | 62 HourClockType type, |
54 AmPmClockType ampm); | 63 AmPmClockType ampm); |
55 | 64 |
56 // Returns a shortened date, e.g. "Nov 7, 2007" | 65 // Returns a shortened date, e.g. "Nov 7, 2007" |
57 BASE_I18N_EXPORT string16 TimeFormatShortDate(const Time& time); | 66 BASE_I18N_EXPORT string16 TimeFormatShortDate(const Time& time); |
58 | 67 |
59 // Returns a numeric date such as 12/13/52. | 68 // Returns a numeric date such as 12/13/52. |
60 BASE_I18N_EXPORT string16 TimeFormatShortDateNumeric(const Time& time); | 69 BASE_I18N_EXPORT string16 TimeFormatShortDateNumeric(const Time& time); |
61 | 70 |
62 // Returns a numeric date and time such as "12/13/52 2:44:30 PM". | 71 // Returns a numeric date and time such as "12/13/52 2:44:30 PM". |
63 BASE_I18N_EXPORT string16 TimeFormatShortDateAndTime(const Time& time); | 72 BASE_I18N_EXPORT string16 TimeFormatShortDateAndTime(const Time& time); |
64 | 73 |
| 74 // Returns a month and year, e.g. "November 2007" |
| 75 BASE_I18N_EXPORT string16 TimeFormatMonthAndYear(const Time& time); |
| 76 |
65 // Returns a numeric date and time with time zone such as | 77 // Returns a numeric date and time with time zone such as |
66 // "12/13/52 2:44:30 PM PST". | 78 // "12/13/52 2:44:30 PM PST". |
67 BASE_I18N_EXPORT string16 | 79 BASE_I18N_EXPORT string16 |
68 TimeFormatShortDateAndTimeWithTimeZone(const Time& time); | 80 TimeFormatShortDateAndTimeWithTimeZone(const Time& time); |
69 | 81 |
70 // Formats a time in a friendly sentence format, e.g. | 82 // Formats a time in a friendly sentence format, e.g. |
71 // "Monday, March 6, 2008 2:44:30 PM". | 83 // "Monday, March 6, 2008 2:44:30 PM". |
72 BASE_I18N_EXPORT string16 TimeFormatFriendlyDateAndTime(const Time& time); | 84 BASE_I18N_EXPORT string16 TimeFormatFriendlyDateAndTime(const Time& time); |
73 | 85 |
74 // Formats a time in a friendly sentence format, e.g. | 86 // Formats a time in a friendly sentence format, e.g. |
(...skipping 17 matching lines...) Expand all Loading... |
92 // | 104 // |
93 // Please don't use width = DURATION_WIDTH_NUMERIC when the time duration | 105 // Please don't use width = DURATION_WIDTH_NUMERIC when the time duration |
94 // can possibly be larger than 24h, as the hour value will be cut below 24 | 106 // can possibly be larger than 24h, as the hour value will be cut below 24 |
95 // after formatting. | 107 // after formatting. |
96 // TODO(chengx): fix function output when width = DURATION_WIDTH_NUMERIC | 108 // TODO(chengx): fix function output when width = DURATION_WIDTH_NUMERIC |
97 // (http://crbug.com/675791) | 109 // (http://crbug.com/675791) |
98 BASE_I18N_EXPORT string16 | 110 BASE_I18N_EXPORT string16 |
99 TimeDurationFormatWithSeconds(const TimeDelta time, | 111 TimeDurationFormatWithSeconds(const TimeDelta time, |
100 const DurationFormatWidth width); | 112 const DurationFormatWidth width); |
101 | 113 |
| 114 // Formats a date interval into various formats, e.g. "2 December - 4 December" |
| 115 // or "March 2016 - December 2016". See DateFormat for details. |
| 116 BASE_I18N_EXPORT string16 DateIntervalFormat(const Time& begin_time, |
| 117 const Time& end_time, |
| 118 DateFormat format); |
| 119 |
102 // Gets the hour clock type of the current locale. e.g. | 120 // Gets the hour clock type of the current locale. e.g. |
103 // k12HourClock (en-US). | 121 // k12HourClock (en-US). |
104 // k24HourClock (en-GB). | 122 // k24HourClock (en-GB). |
105 BASE_I18N_EXPORT HourClockType GetHourClockType(); | 123 BASE_I18N_EXPORT HourClockType GetHourClockType(); |
106 | 124 |
107 } // namespace base | 125 } // namespace base |
108 | 126 |
109 #endif // BASE_I18N_TIME_FORMATTING_H_ | 127 #endif // BASE_I18N_TIME_FORMATTING_H_ |
OLD | NEW |