- Форматирование даты в Java с помощью SimpleDateFormat
- Руководство по SimpleDateFormat
- 1. введение
- 2. Простое Создание Экземпляра
- 2.1. Заводские методы
- 2.2. Безопасность резьбы
- 3. Анализ Дат
- 4. Шаблоны Даты и времени
- 5. Применение локализаций
- 6. Смена часовых Поясов
- 7. Резюме
- Android studio simpledateformat пример
- Date and Time Patterns
- Examples
- Synchronization
Форматирование даты в Java с помощью SimpleDateFormat
Для форматирования ввода и вывода даты в Java до введения нового Date Time API (https://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html), который был введен в Java 8, использовался класс SimpleDateFormat.
SimpleDateFormat является подклассом DateFormat, который позволяет форматировать ввод-вывод даты и времени в рамках предопределенных стилей. В отличие от DateFormat, SimpleDateFormat позволяет создавать собственные настраиваемые форматы ввода-вывода.
Для создания экземпляра класса SimpleDateFormat используется один из 4 конструкторов:
- SimpleDateFormat()
- SimpleDateFormat(String pattern)
- SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)
- SimpleDateFormat(String pattern, Locale locale)
pattern – шаблон определяющий формат даты и времени
formatSymbols – символы формата даты (например название месяцев или дней недели)
locale — локаль
SimpleDateFormat чувствителен к локали. При создании экземпляра SimpleDateFormat без параметра Locale, вывод будет форматироваться в соответствии с Locale по умолчанию.
Синтаксис шаблона форматирования даты
Символ | Значение | Представление | Пример |
G | обозначение эры | Текст | AD, н.э. |
y или yyyy | год (4 цифры) | Число | 2017 |
yy | год (2 последние цифры) | Число | 17 |
M | номер месяца без лидирующих нулей | Число | 1, 11 |
MM | номер месяца дополненный нулями | Число | 01, 11 |
MMM | сокращенное название месяца | Текст | дек, Dec |
MMMM | полное название месяца (контекстно-зависимое) | Текст | декабря, December |
LLLL | полное название месяца (контекстно-независимое) | Текст | Декабрь, December |
w | неделя в году | Число | 13 |
W | неделя в месяце | Число | 3 |
D | день в году | Число | 172 |
d | день месяца | Число | 11 |
F | день недели в месяце | Число | 1 |
E | сокращенное название дня недели | Текст | Ср, Wed |
EEEE | полное название дня недели | Текст | среда, Wednesday |
u | номер дня недели (1-пн .. 7-вск) | Число | 3 |
a | маркер am/pm | Текст | AM |
H | Час в дне (0-23) | Число | 0 |
h | Часы в am/pm (1-12) | Число | 12 |
K | час в am/pm (0-11) | Число | 0 |
k | час в дне (1-24) | Число | 24 |
m | минута в часе | Число | 18 |
s | секунда в минуте | Число | 35 |
S | миллисекунды | Число | 978 |
z | часовой пояс | Текст | GMT+07:00 |
Z | часовой пояс в формате RFC 822 | Текст | 700 |
X | часовой пояс в формате ISO 8601 | Текст | 7 |
Символы, не являющиеся буквами обрабатываются как текст в кавычках.
Число используемых буквенных символов также определяет формат:
- Для текстового представления 1-3 символа указывают на сокращенную форму записи, тогда как 4+ символа – на полную форму.
- Для числовых представлений число символов указывает на минимальное требуемое число цифр. Более короткое число дополняется лидирующими нулями.
Источник
Руководство по SimpleDateFormat
Краткое руководство по использованию SimpleDateFormat в Java.
Автор: Sam Millington
Дата записи
1. введение
В этом уроке мы проведем углубленную экскурсию по классу SimpleDateFormat .
Мы рассмотрим простые экземпляры | и стили форматирования , а также полезные методы, которые класс предоставляет для обработки локалей и часовых поясов .
2. Простое Создание Экземпляра
Во-первых, давайте рассмотрим, как создать экземпляр нового объекта SimpleDateFormat .
Есть 4 возможных конструктора – но в соответствии с названием давайте все упростим. Все, что нам нужно для начала, – это Строка представление шаблона даты , который мы хотим .
Давайте начнем с шаблона даты, разделенного черточками, вот так:
Это позволит правильно отформатировать дату, начиная с текущего дня месяца, текущего месяца года и, наконец, текущего года. Мы можем протестировать наш новый форматер с помощью простого модульного теста. Мы создадим новый объект SimpleDateFormat и передадим известную дату:
В приведенном выше коде форматер преобразует миллисекунды как длинные ong в читаемую человеком дату-24 мая 1977 года.
2.1. Заводские методы
Хотя SimpleDateFormat является удобным классом для быстрого создания средства форматирования данных, нам рекомендуется использовать заводские методы в DateFormat классе | getDateFormat () , getDateTimeFormat () , getTimeFormat() .
Приведенный выше пример выглядит немного иначе при использовании этих заводских методов:
Как видно из приведенного выше, количество параметров форматирования предопределено полями в классе DateFormat . Это в значительной степени ограничивает наши доступные варианты форматирования , поэтому в этой статье мы будем придерживаться SimpleDateFormat .
2.2. Безопасность резьбы
В JavaDoc для SimpleDateFormat явно указано:
Форматы дат не синхронизируются. Рекомендуется создавать отдельные экземпляры формата для каждого потока. Если несколько потоков одновременно обращаются к формату, он должен быть синхронизирован извне.
Таким образом , экземпляры SimpleDateFormat не являются потокобезопасными , и мы должны осторожно использовать их в параллельных средах.
Лучший подход к решению этой проблемы состоит в том, чтобы использовать их в сочетании с ThreadLocal . Таким образом, каждый поток получает свой собственный экземпляр SimpleDateFormat , а отсутствие общего доступа делает программу потокобезопасной:
Аргумент для метода with Initial является поставщиком экземпляров SimpleDateFormat . Каждый раз, когда ThreadLocal необходимо создать экземпляр, он будет использовать этого поставщика.
Затем мы можем использовать форматер через экземпляр ThreadLocal :
Метод ThreadLocal.get() сначала инициализирует SimpleDateFormat для текущего потока, а затем повторно использует этот экземпляр.
Мы называем эту технику ограничение потока поскольку мы ограничиваем использование каждого экземпляра одним конкретным потоком.
Есть два других подхода к решению той же проблемы:
- Использование синхронизированных блоков или ReentrantLock s
- Создание ненужных экземпляров SimpleDateFormat по требованию
Оба этих подхода не рекомендуются: первый приводит к значительному снижению производительности, когда конкуренция высока, а второй создает много объектов, оказывая давление на сборку мусора.
Стоит отметить, что начиная с Java 8, был введен новый DateTimeFormatter класс . Новый класс DateTimeFormatter является неизменяемым и потокобезопасным. Если мы работаем с Java 8 или более поздней версией, рекомендуется использовать новый класс DateTimeFormatter .
3. Анализ Дат
SimpleDateFormat и DateFormat не только позволяют нам форматировать даты, но мы также можем отменить операцию. Используя метод parse , мы можем ввести строковое представление даты и вернуть эквивалент даты объекта:
Здесь важно отметить, что шаблон , предоставленный в конструкторе, должен быть в том же формате, что и дата, проанализированная с помощью метода parse .
4. Шаблоны Даты и времени
SimpleDateFormat предоставляет широкий спектр различных опций при форматировании дат. Хотя полный список доступен в JavaDocs , давайте рассмотрим некоторые из наиболее часто используемых опций:
M | 12; Дек | Месяц |
y | 94 | год |
d | 23; Пн | день |
H | 03 | час |
m | 57 | минута |
Вывод , возвращаемый компонентом date, также сильно зависит от количества символов, используемых в строке . Например, возьмем июнь месяц. Если мы определим строку даты как:
Тогда наш результат будет выглядеть как код номера – 06. Однако, если мы добавим еще один M в нашу строку даты:
Затем наши результирующие отформатированные данные отображаются в виде слова Jun .
5. Применение локализаций
Класс SimpleDateFormat также поддерживает широкий диапазон локализаций , который устанавливается при вызове конструктора.
Давайте применим это на практике, отформатировав дату на французском языке. Мы создадим экземпляр объекта SimpleDateFormat , предоставив Locale.ФРАНЦИЯ к конструктору.
Указав заданную дату, в среду днем, мы можем утверждать, что наш france DateFormatter правильно отформатировал дату. Новая дата правильно начинается с Vendredi -Французский для среды!
Стоит отметить небольшую ошибку в версии Locale конструктора – хотя поддерживаются многие локали, полное покрытие не гарантируется . Oracle рекомендует использовать заводские методы в классе DateFormat для обеспечения локального покрытия.
6. Смена часовых Поясов
Поскольку SimpleDateFormat расширяет класс DateFormat , мы также можем манипулировать часовым поясом с помощью метода setTimeZone . Давайте посмотрим на это в действии:
В приведенном выше примере мы поставляем одну и ту же Дату в два разных часовых пояса одного и того же объекта SimpleDateFormat . Мы также добавили символ ‘Z’ в конец шаблона String , чтобы указать различия в часовых поясах . Вывод из метода format затем регистрируется для пользователя.
Нажав run, мы можем увидеть текущее время относительно двух часовых поясов:
7. Резюме
В этом уроке мы глубоко погрузились в тонкости SimpleDateFormat .
Мы рассмотрели, как создать экземпляр SimpleDateFormat , а также как шаблон Строка влияет на форматирование даты .
Мы поиграли с изменением локалей выходной строки, прежде чем, наконец, поэкспериментировать с использованием часовых поясов .
Как всегда, полный исходный код можно найти на GitHub .
Источник
Android studio simpledateformat пример
SimpleDateFormat allows you to start by choosing any user-defined patterns for date-time formatting. However, you are encouraged to create a date-time formatter with either getTimeInstance , getDateInstance , or getDateTimeInstance in DateFormat . Each of these class methods can return a date/time formatter initialized with a default format pattern. You may modify the format pattern using the applyPattern methods as desired. For more information on using these methods, see DateFormat .
Date and Time Patterns
Date and time formats are specified by date and time pattern strings. Within date and time pattern strings, unquoted letters from ‘A’ to ‘Z’ and from ‘a’ to ‘z’ are interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single quotes ( ‘ ) to avoid interpretation. «»» represents a single quote. All other characters are not interpreted; they’re simply copied into the output string during formatting or matched against the input string during parsing.
The following pattern letters are defined (all other characters from ‘A’ to ‘Z’ and from ‘a’ to ‘z’ are reserved):
Letter Date or Time Component Presentation Examples G Era designator Text AD y Year Year 1996 ; 96 Y Week year Year 2009 ; 09 M Month in year (context sensitive) Month July ; Jul ; 07 L Month in year (standalone form) Month July ; Jul ; 07 w Week in year Number 27 W Week in month Number 2 D Day in year Number 189 d Day in month Number 10 F Day of week in month Number 2 E Day name in week Text Tuesday ; Tue u Day number of week (1 = Monday, . 7 = Sunday) Number 1 a Am/pm marker Text PM H Hour in day (0-23) Number 0 k Hour in day (1-24) Number 24 K Hour in am/pm (0-11) Number 0 h Hour in am/pm (1-12) Number 12 m Minute in hour Number 30 s Second in minute Number 55 S Millisecond Number 978 z Time zone General time zone Pacific Standard Time ; PST ; GMT-08:00 Z Time zone RFC 822 time zone -0800 X Time zone ISO 8601 time zone -08 ; -0800 ; -08:00
Pattern letters are usually repeated, as their number determines the exact presentation:
- Text: For formatting, if the number of pattern letters is 4 or more, the full form is used; otherwise a short or abbreviated form is used if available. For parsing, both forms are accepted, independent of the number of pattern letters.
Number: For formatting, the number of pattern letters is the minimum number of digits, and shorter numbers are zero-padded to this amount. For parsing, the number of pattern letters is ignored unless it’s needed to separate two adjacent fields.
- For formatting, if the number of pattern letters is 2, the year is truncated to 2 digits; otherwise it is interpreted as a number.
- For parsing, if the number of pattern letters is more than 2, the year is interpreted literally, regardless of the number of digits. So using the pattern «MM/dd/yyyy», «01/11/12» parses to Jan 11, 12 A.D.
- For parsing with the abbreviated year pattern («y» or «yy»), SimpleDateFormat must interpret the abbreviated year relative to some century. It does this by adjusting dates to be within 80 years before and 20 years after the time the SimpleDateFormat instance is created. For example, using a pattern of «MM/dd/yy» and a SimpleDateFormat instance created on Jan 1, 1997, the string «01/11/12» would be interpreted as Jan 11, 2012 while the string «05/04/64» would be interpreted as May 4, 1964. During parsing, only strings consisting of exactly two digits, as defined by Character.isDigit(char) , will be parsed into the default century. Any other numeric string, such as a one digit string, a three or more digit string, or a two digit string that isn’t all digits (for example, «-1»), is interpreted literally. So «01/02/3» or «01/02/003» are parsed, using the same pattern, as Jan 2, 3 AD. Likewise, «01/02/-3» is parsed as Jan 2, 4 BC.
Otherwise, calendar system specific forms are applied. For both formatting and parsing, if the number of pattern letters is 4 or more, a calendar specific long form is used. Otherwise, a calendar specific short or abbreviated form is used.
If week year ‘Y’ is specified and the calendar doesn’t support any week years, the calendar year ( ‘y’ ) is used instead. The support of week years can be tested with a call to getCalendar() . isWeekDateSupported() .
- Letter M produces context-sensitive month names, such as the embedded form of names. If a DateFormatSymbols has been set explicitly with constructor SimpleDateFormat(String, DateFormatSymbols) or method setDateFormatSymbols(DateFormatSymbols) , the month names given by the DateFormatSymbols are used.
- Letter L produces the standalone form of month names.
For parsing, RFC 822 time zones are also accepted.
RFC 822 time zone: For formatting, the RFC 822 4-digit time zone format is used: TwoDigitHours must be between 00 and 23. Other definitions are as for general time zones.
For parsing, general time zones are also accepted.
ISO 8601 Time zone: The number of pattern letters designates the format for both formatting and parsing as follows: Other definitions are as for general time zones or RFC 822 time zones.
For formatting, if the offset value from GMT is 0, «Z» is produced. If the number of pattern letters is 1, any fraction of an hour is ignored. For example, if the pattern is «X» and the time zone is «GMT+05:30» , «+05» is produced.
For parsing, «Z» is parsed as the UTC time zone designator. General time zones are not accepted.
If the number of pattern letters is 4 or more, IllegalArgumentException is thrown when constructing a SimpleDateFormat or applying a pattern.
SimpleDateFormat also supports localized date and time pattern strings. In these strings, the pattern letters described above may be replaced with other, locale dependent, pattern letters. SimpleDateFormat does not deal with the localization of text other than the pattern letters; that’s up to the client of the class.
Examples
Date and Time Pattern Result «yyyy.MM.dd G ‘at’ HH:mm:ss z» 2001.07.04 AD at 12:08:56 PDT «EEE, MMM d, »yy» Wed, Jul 4, ’01 «h:mm a» 12:08 PM «hh ‘o»clock’ a, zzzz» 12 o’clock PM, Pacific Daylight Time «K:mm a, z» 0:08 PM, PDT «yyyyy.MMMMM.dd GGG hh:mm aaa» 02001.July.04 AD 12:08 PM «EEE, d MMM yyyy HH:mm:ss Z» Wed, 4 Jul 2001 12:08:56 -0700 «yyMMddHHmmssZ» 010704120856-0700 «yyyy-MM-dd’T’HH:mm:ss.SSSZ» 2001-07-04T12:08:56.235-0700 «yyyy-MM-dd’T’HH:mm:ss.SSSXXX» 2001-07-04T12:08:56.235-07:00 «YYYY-‘W’ww-u» 2001-W27-3
Synchronization
Date formats are not synchronized. It is recommended to create separate format instances for each thread. If multiple threads access a format concurrently, it must be synchronized externally.
Источник