DateFormat Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
DateFormat — абстрактный класс для подклассов форматирования даты и времени, которые форматируют и анализируют даты или время независимо от языка.
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format- Наследование
- Производный
- Атрибуты
Комментарии
DateFormat — абстрактный класс для подклассов форматирования даты и времени, которые форматируют и анализируют даты или время независимо от языка. Подкласс форматирования даты и времени, например SimpleDateFormat, позволяет отформатировать (т. е. текст даты и времени), синтаксический анализ (дата и дата rarr;) и нормализацию. Дата представлена как Date объект или в миллисекундах с 1 января 1970 г., 00:00:00 GMT.
DateFormat предоставляет множество методов класса для получения средств форматирования даты и времени по умолчанию на основе заданного языкового стандарта или ряда стилей форматирования. Стили форматирования включают #FULL, #LONG#MEDIUMи #SHORT. Дополнительные сведения и примеры использования этих стилей приведены в описаниях методов.
DateFormat помогает отформатировать и проанализировать даты для любого языкового стандарта. Код может быть полностью независимым от соглашений языкового стандарта в течение нескольких месяцев, дней недели или даже формата календаря: лунный и солнечный.
Чтобы отформатировать дату текущего языкового стандарта, используйте один из статических методов фабрики: <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</blockquote>
При форматировании нескольких дат эффективнее получить формат и использовать его несколько раз, чтобы система не собиралась получать сведения о местных языках и соглашениях стран несколько раз. <blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</blockquote>
Чтобы отформатировать дату для другого языкового стандарта, укажите ее в вызове #getDateInstance(int, Locale) getDateInstance().
<blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</blockquote>
Для синтаксического анализа также можно использовать DateFormat. <blockquote>
{@code
myDate = df.parse(myString);
}
</blockquote>
Используется getDateInstance для получения обычного формата дат для этой страны. Доступны другие статические методы фабрики. Используется getTimeInstance для получения формата времени для этой страны. Используется getDateTimeInstance для получения формата даты и времени. Вы можете передать различные параметры в эти методы фабрики, чтобы контролировать длину результата; от #SHORT до #MEDIUM#LONG#FULL. Точный результат зависит от языкового стандарта, но в целом: <ul><li>#SHORT полностью числовое, например или li12.13.523:30pm длиннее, например<>#MEDIUM, li длиннее,Jan 12, 1952<>#LONGJanuary 12, 1952 например3:30:32pm<, или ли>#FULL довольно полностью указано, например.Tuesday, April 12, 1952 AD or 3:30:42pm PST
</ul>
Вы также можете задать часовой пояс в формате, если вы хотите. Если вы хотите еще больше контроля над форматом или анализом (или хотите предоставить пользователям больше контроля), вы можете попробовать приведение DateFormat методов фабрики к методу SimpleDateFormat. Это будет работать для большинства стран; просто не забудьте положить его в try блок в случае, если вы столкнулись с необычным.
Кроме того, можно использовать формы методов синтаксического анализа и форматирования и ParsePositionFieldPosition разрешить <><>постепенно анализировать фрагменты строки.
<li>выровнять любое определенное поле или узнать, где он предназначен для выбора на экране.
</ul>
<h2>"синхронизация">Синхронизация</h2>
Форматы дат не синхронизируются. Рекомендуется создать отдельные экземпляры формата для каждого потока. Если несколько потоков одновременно обращаются к формату, он должен быть синхронизирован вневне.
Добавлено в версии 1.1.
Java документации по java.text.DateFormat.
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Конструкторы
| Имя. | Описание |
|---|---|
| DateFormat() |
Создайте новый формат даты. |
| DateFormat(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
Поля
| Имя. | Описание |
|---|---|
| AmPmField |
Полезная константа для выравнивания полей AM_PM. |
| DateField |
Полезная константа для выравнивания полей DATE. |
| DayOfWeekField |
Полезная константа для выравнивания полей DAY_OF_WEEK. |
| DayOfWeekInMonthField |
Полезная константа для выравнивания полей DAY_OF_WEEK_IN_MONTH. |
| DayOfYearField |
Полезная константа для выравнивания полей DAY_OF_YEAR. |
| Default |
Константа для шаблона стиля по умолчанию. |
| EraField |
Полезная константа для выравнивания полей ERA. |
| Full |
Константная для полного шаблона стиля. |
| Hour0Field |
Полезная константа для выравнивания полей с нуля. |
| Hour1Field |
Полезная константа для выравнивания полей НА основе одного часа. |
| HourOfDay0Field |
Полезная константа для выравнивания полей на основе нуля HOUR_OF_DAY. |
| HourOfDay1Field |
Полезная константа для выравнивания полей на основе одного HOUR_OF_DAY. |
| Long |
Константная для длинного шаблона стиля. |
| Medium |
Константа для шаблона среднего стиля. |
| MillisecondField |
Полезная константа для выравнивания полей MILLISECOND. |
| MinuteField |
Полезная константа для выравнивания полей MINUTE. |
| MonthField |
Полезная константа для выравнивания полей MONTH. |
| SecondField |
Полезная константа для выравнивания полей SECOND. |
| Short |
Константа для короткого шаблона стиля. |
| TimezoneField |
Полезная константа для выравнивания полей TIMEZONE. |
| WeekOfMonthField |
Полезная константа для выравнивания полей WEEK_OF_MONTH. |
| WeekOfYearField |
Полезная константа для выравнивания полей WEEK_OF_YEAR. |
| YearField |
Полезная константа для выравнивания полей YEAR. |
Свойства
| Имя. | Описание |
|---|---|
| Calendar |
Возвращает календарь, связанный с этим форматировщиком даты и времени. -или- Задайте календарь, используемый в этом формате даты. |
| Class |
Возвращает класс среды выполнения этого |
| DateInstance |
Возвращает модуль форматирования дат с стилем форматирования по умолчанию для языкового стандарта по умолчанию |
| DateTimeInstance |
Получает форматировщик даты и времени с стилем форматирования по умолчанию для языкового стандарта по умолчанию |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| Instance |
Получите модуль форматирования даты и времени по умолчанию, который использует стиль SHORT для даты и времени. |
| JniIdentityHashCode |
Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Lenient |
Укажите, является ли синтаксический анализ даты и времени мягким. -или- Укажите, является ли синтаксический анализ даты и времени мягким. |
| NumberFormat |
Получает метод форматирования чисел, который используется этим методом форматирования даты и времени для форматирования и анализа времени. -или- Позволяет задать форматировщик чисел. |
| PeerReference |
Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object) |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
| TimeInstance |
Получает форматировщик времени с стилем форматирования по умолчанию для языкового стандарта по умолчанию |
| TimeZone |
Возвращает часовой пояс. -или- задает часовой пояс для календаря этого |
Методы
| Имя. | Описание |
|---|---|
| Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| Dispose(Boolean) |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
Указывает, равен ли другой объект этому объекту. (Унаследовано от Object) |
| Format(Date, StringBuffer, FieldPosition) |
|
| Format(Date) |
|
| Format(Object, StringBuffer, FieldPosition) |
Форматирует заданную |
| Format(Object) |
Форматирует объект для создания строки. (Унаследовано от _Format) |
| FormatToCharacterIterator(Object) |
Форматирует объект, создающий |
| GetAvailableLocales() |
Возвращает массив всех языковых стандартов, для которых |
| GetDateInstance(Int32, Locale) |
Получает форматировщик дат с заданным стилем форматирования для заданного языкового стандарта. |
| GetDateInstance(Int32) |
Возвращает модуль форматирования дат с заданным стилем форматирования для языкового стандарта по умолчанию |
| GetDateTimeInstance(Int32, Int32, Locale) |
Возвращает модуль форматирования даты и времени с заданными стилями форматирования для заданного языкового стандарта. |
| GetDateTimeInstance(Int32, Int32) |
Возвращает форматировщик даты и времени с заданными стилями форматирования даты и времени для языкового стандарта по умолчанию |
| GetHashCode() |
Возвращает хэш-значение кода для объекта. (Унаследовано от Object) |
| GetTimeInstance(Int32, Locale) |
Возвращает модуль форматирования времени с заданным стилем форматирования для заданного языкового стандарта. |
| GetTimeInstance(Int32) |
Возвращает модуль форматирования времени с заданным стилем форматирования для языкового стандарта по умолчанию |
| JavaFinalize() |
Устаревшие.
Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object) |
| Notify() |
Просыпается один поток, ожидающий монитора этого объекта. (Унаследовано от Object) |
| NotifyAll() |
Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object) |
| Parse(String, ParsePosition) |
Анализ строки даты и времени в соответствии с заданной позицией синтаксического анализа. |
| Parse(String) |
Анализирует текст с начала заданной строки для создания даты. |
| ParseObject(String, ParsePosition) |
Анализирует текст из строки для создания |
| ParseObject(String) |
Анализирует текст с начала заданной строки для создания объекта. (Унаследовано от _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| ToArray<T>() |
Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object) |
| ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
| UnregisterFromRuntime() |
Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object) |
| Wait() |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, путем <><уведомления/>em или <эм>прерванного</em.> (Унаследовано от Object) |
| Wait(Int64, Int32) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
| Wait(Int64) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прерваны< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя. | Описание |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
Методы расширения
| Имя. | Описание |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Возвращает имя JNI типа экземпляра |
| JavaAs<TResult>(IJavaPeerable) |
Попробуйте принуждать к типу |
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Попробуйте принуждать к типу |