Язык

DateFormat.Parse Метод

Определение

Перегрузки

Имя. Описание
Parse(String, ParsePosition)

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа.

Parse(String, Calendar, ParsePosition)

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа.

Parse(String)

Анализирует строку даты и времени.

Parse(String, ParsePosition)

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа.

[Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/text/ParsePosition;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Ljava_text_ParsePosition_Handler", ApiSince=24)]
public virtual Java.Util.Date? Parse(string? text, Java.Text.ParsePosition? pos);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;Ljava/text/ParsePosition;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Ljava_text_ParsePosition_Handler", ApiSince=24)>]
abstract member Parse : string * Java.Text.ParsePosition -> Java.Util.Date
override this.Parse : string * Java.Text.ParsePosition -> Java.Util.Date

Параметры

text
String

Строка даты и времени для синтаксического анализа

pos
ParsePosition

На входных данных позиция, с которой начинается синтаксический анализ; в выходных данных позиция, в которой завершается синтаксический анализ, или начальная позиция, если синтаксический анализ завершился сбоем.

Возвращаемое значение

Дата или значение NULL, если входные данные не удалось проанализировать

Атрибуты

Комментарии

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа. Например, текст времени "07/10/96 4:5 pm, PDT" будет проанализирован в дату, эквивалентную дате (837039928046).

По умолчанию синтаксический анализ является мягким: если входные данные не в форме, используемой методом форматирования этого объекта, но по-прежнему могут быть проанализированы как дата, то синтаксический анализ завершается успешно. Клиенты могут настаивать на строгом соблюдении формата, вызвав setLenient(false).

Обратите внимание, что обычные форматы дат, связанные с некоторыми календарями , например китайский лунный календарь, не указывают достаточно полей, чтобы включить синтаксический анализ дат однозначно. В случае китайского лунного календаря, в то время как год в текущем 60-летнем цикле указывается, число таких циклов с даты начала календаря (в поле ERA объекта Calendar) обычно не является частью формата, и синтаксический анализ может предполагать неправильную эпоху. В таких случаях рекомендуется выполнять синтаксический анализ клиентов с помощью метода синтаксического анализа, который принимает календарь с календарем, переданным в соответствии с текущей датой, или датой в пределах эры или цикла, которую следует предполагать, если отсутствует в формате.

Java документации по android.icu.text.DateFormat.parse(java.lang.String, java.text.ParsePosition).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к

Parse(String, Calendar, ParsePosition)

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа.

[Android.Runtime.Register("parse", "(Ljava/lang/String;Landroid/icu/util/Calendar;Ljava/text/ParsePosition;)V", "GetParse_Ljava_lang_String_Landroid_icu_util_Calendar_Ljava_text_ParsePosition_Handler", ApiSince=24)]
public abstract void Parse(string? text, Android.Icu.Util.Calendar? cal, Java.Text.ParsePosition? pos);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;Landroid/icu/util/Calendar;Ljava/text/ParsePosition;)V", "GetParse_Ljava_lang_String_Landroid_icu_util_Calendar_Ljava_text_ParsePosition_Handler", ApiSince=24)>]
abstract member Parse : string * Android.Icu.Util.Calendar * Java.Text.ParsePosition -> unit

Параметры

text
String

Строка даты и времени для синтаксического анализа

cal
Calendar

Календарь, заданный для входных данных, даты и времени, используемых для отсутствующих значений в синтаксическом анализе строки даты и времени, а также для выходных данных для синтаксического анализа даты и времени. Как правило, перед вызовом этого метода следует инициализировать — очистить или задать текущую дату в зависимости от требуемого поведения. Если этот синтаксический анализ завершается ошибкой, календарь может быть изменен. Если тип календаря отличается от внутреннего календаря, удерживаемого этим экземпляром DateFormat, значения полей календаря будут проанализированы на основе внутреннего календаря, инициализированного времени и часового пояса, взятого из этого календаря, а результат синтаксического анализа (время в миллисекундах и часовом поясе) будет возвращен в этот календарь.

pos
ParsePosition

На входных данных позиция, с которой начинается синтаксический анализ; в выходных данных позиция, в которой завершается синтаксический анализ, или начальная позиция, если синтаксический анализ завершился сбоем.

Атрибуты

Комментарии

Анализирует строку даты и времени в соответствии с заданной позицией синтаксического анализа. Например, текст времени "07/10/96 4:5 pm, PDT" будет проанализирован в календаре, эквивалентном date(837039928046). Перед вызовом этого метода вызывающий объект должен инициализировать календарь одним из двух способов (если не требуется хранить существующие сведения о поле): (1) очистить календарь или (2) задать календарь на текущую дату (или любую дату, поля которой должны использоваться для предоставления значений, отсутствующих в дате синтаксического анализа). Например, даты китайского календаря обычно не предоставляют эру или цикл; В этом случае календарь, который передается, должен быть задан на дату в течение эпохи, которую следует предположить, как правило, текущей эры.

По умолчанию синтаксический анализ является мягким: если входные данные не в форме, используемой методом форматирования этого объекта, но по-прежнему могут быть проанализированы как дата, то синтаксический анализ завершается успешно. Клиенты могут настаивать на строгом соблюдении формата, вызвав setLenient(false).

Java документации по android.icu.text.DateFormat.parse(java.lang.String, android.icu.util.Calendar, java.text.ParsePosition).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к

Parse(String)

Анализирует строку даты и времени.

[Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Handler", ApiSince=24)]
public virtual Java.Util.Date? Parse(string? text);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;)Ljava/util/Date;", "GetParse_Ljava_lang_String_Handler", ApiSince=24)>]
abstract member Parse : string -> Java.Util.Date
override this.Parse : string -> Java.Util.Date

Параметры

text
String

Строка даты и времени для синтаксического анализа

Возвращаемое значение

Дата или значение NULL, если входные данные не удалось проанализировать

Атрибуты

Комментарии

Анализирует строку даты и времени. Например, текст времени "07/10/96 4:5 pm, PDT" будет проанализирован в дату, эквивалентную дате (837039928046). Синтаксический анализ начинается в начале строки и продолжается насколько это возможно. Если ошибка синтаксического анализа не обнаружена, эта функция не возвращает никаких сведений о том, сколько строк было занято синтаксического анализа. Если вам нужна эта информация, используйте версию parse(), которая принимает ParsePosition.

По умолчанию синтаксический анализ является мягким: если входные данные не в форме, используемой методом форматирования этого объекта, но по-прежнему могут быть проанализированы как дата, то синтаксический анализ завершается успешно. Клиенты могут настаивать на строгом соблюдении формата, вызвав setLenient(false).

Обратите внимание, что обычные форматы дат, связанные с некоторыми календарями , например китайский лунный календарь, не указывают достаточно полей, чтобы включить синтаксический анализ дат однозначно. В случае китайского лунного календаря, в то время как год в текущем 60-летнем цикле указывается, число таких циклов с даты начала календаря (в поле ERA объекта Calendar) обычно не является частью формата, и синтаксический анализ может предполагать неправильную эпоху. В таких случаях рекомендуется выполнять синтаксический анализ клиентов с помощью метода синтаксического анализа, который принимает календарь с календарем, переданным в соответствии с текущей датой, или датой в пределах эры или цикла, которую следует предполагать, если отсутствует в формате.

Java документации по android.icu.text.DateFormat.parse(java.lang.String).

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Применяется к