DateFormat.Parse Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| Parse(String, ParsePosition) |
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida. |
| Parse(String, Calendar, ParsePosition) |
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida. |
| Parse(String) |
Analisa uma cadeia de caracteres de data/hora. |
Parse(String, ParsePosition)
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida.
[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
Parâmetros
- text
- String
A cadeia de caracteres de data/hora a ser analisada
- pos
- ParsePosition
Na entrada, a posição na qual iniciar a análise; na saída, a posição na qual a análise foi encerrada ou a posição inicial se a análise falhou.
Retornos
Uma data ou nulo se a entrada não puder ser analisada
- Atributos
Comentários
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida. Por exemplo, um texto de hora "07/10/96 16:5 pm, PDT" será analisado em uma Data equivalente a Date(837039928046).
Por padrão, a análise é branda: se a entrada não estiver no formulário usado pelo método de formato desse objeto, mas ainda puder ser analisada como uma data, a análise será bem-sucedida. Os clientes podem insistir na adesão estrita ao formato chamando setLenient(false).
Observe que os formatos de data normais associados a alguns calendários - como o calendário lunar chinês - não especificam campos suficientes para permitir que as datas sejam analisadas de forma inequívoca. No caso do calendário lunar chinês, enquanto o ano dentro do ciclo atual de 60 anos é especificado, o número desses ciclos desde a data de início do calendário (no campo ERA do objeto Calendar) normalmente não faz parte do formato, e a análise pode assumir a era errada. Para casos como esse, é recomendável que os clientes analisem usando o método de análise que usa um Calendário com o Calendário passado definido para a data atual ou para uma data dentro da era/ciclo que deve ser assumida se ausente no formato.
Java documentação para android.icu.text.DateFormat.parse(java.lang.String, java.text.ParsePosition).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
Parse(String, Calendar, ParsePosition)
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida.
[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
Parâmetros
- text
- String
A cadeia de caracteres de data/hora a ser analisada
- cal
- Calendar
O calendário definido na entrada para a data e hora a serem usadas para valores ausentes na cadeia de caracteres de data/hora que está sendo analisada e definido na saída para a data/hora analisada. Em geral, isso deve ser inicializado antes de chamar esse método – desmarcado ou definido como a data atual, dependendo do comportamento desejado. Se essa análise falhar, o calendário ainda poderá ter sido modificado. Quando o tipo de calendário for diferente do calendário interno mantido por essa instância DateFormat, os valores do campo de calendário serão analisados com base no calendário interno inicializado com o tempo e o fuso horário tirado desse calendário, então o resultado da análise (tempo em milissegundos e fuso horário) será definido novamente para este calendário.
- pos
- ParsePosition
Na entrada, a posição na qual iniciar a análise; na saída, a posição na qual a análise foi encerrada ou a posição inicial se a análise falhou.
- Atributos
Comentários
Analisa uma cadeia de caracteres de data/hora de acordo com a posição de análise fornecida. Por exemplo, um texto de hora "07/10/96 16:5, PDT" será analisado em um Calendário equivalente a Date(837039928046). Antes de chamar esse método, o chamador deve inicializar o calendário de duas maneiras (a menos que as informações de campo existentes sejam mantidas): (1) desmarque o calendário ou (2) defina o calendário como a data atual (ou para qualquer data cujos campos devem ser usados para fornecer valores ausentes na data analisada). Por exemplo, as datas do calendário chinês normalmente não fornecem uma era/ciclo; nesse caso, o calendário passado deve ser definido como uma data dentro da era que deve ser assumida, normalmente a era atual.
Por padrão, a análise é branda: se a entrada não estiver no formulário usado pelo método de formato desse objeto, mas ainda puder ser analisada como uma data, a análise será bem-sucedida. Os clientes podem insistir na adesão estrita ao formato chamando setLenient(false).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.
Aplica-se a
Parse(String)
Analisa uma cadeia de caracteres de data/hora.
[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
Parâmetros
- text
- String
A cadeia de caracteres de data/hora a ser analisada
Retornos
Uma data ou nulo se a entrada não puder ser analisada
- Atributos
Comentários
Analisa uma cadeia de caracteres de data/hora. Por exemplo, um texto de hora "07/10/96 16:5 pm, PDT" será analisado em uma Data equivalente a Date(837039928046). A análise começa no início da cadeia de caracteres e prossegue o mais longe possível. Supondo que nenhum erro de análise tenha sido encontrado, essa função não retorna nenhuma informação sobre quanto da cadeia de caracteres foi consumida pela análise. Se você precisar dessas informações, use uma versão de parse() que usa uma ParsePosition.
Por padrão, a análise é branda: se a entrada não estiver no formulário usado pelo método de formato desse objeto, mas ainda puder ser analisada como uma data, a análise será bem-sucedida. Os clientes podem insistir na adesão estrita ao formato chamando setLenient(false).
Observe que os formatos de data normais associados a alguns calendários - como o calendário lunar chinês - não especificam campos suficientes para permitir que as datas sejam analisadas de forma inequívoca. No caso do calendário lunar chinês, enquanto o ano dentro do ciclo atual de 60 anos é especificado, o número desses ciclos desde a data de início do calendário (no campo ERA do objeto Calendar) normalmente não faz parte do formato, e a análise pode assumir a era errada. Para casos como esse, é recomendável que os clientes analisem usando o método de análise que usa um Calendário com o Calendário passado definido para a data atual ou para uma data dentro da era/ciclo que deve ser assumida se ausente no formato.
Java documentação para android.icu.text.DateFormat.parse(java.lang.String).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.