Date.Parse(String) Método

Definição

Cuidado

deprecated

Tenta interpretar a cadeia de caracteres s como uma representação de uma data e hora.

[Android.Runtime.Register("parse", "(Ljava/lang/String;)J", "")]
[System.Obsolete("deprecated")]
public static long Parse(string? s);
[<Android.Runtime.Register("parse", "(Ljava/lang/String;)J", "")>]
[<System.Obsolete("deprecated")>]
static member Parse : string -> int64

Parâmetros

s
String

uma cadeia de caracteres a ser analisada como uma data.

Retornos

o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT representado pelo argumento de cadeia de caracteres.

Atributos

Comentários

Tenta interpretar a cadeia de caracteres s como uma representação de uma data e hora. Se a tentativa for bem-sucedida, o tempo indicado será retornado representado como a distância, medida em milissegundos, da época (00:00:00 GMT em 1º de janeiro de 1970). Se a tentativa falhar, uma IllegalArgumentException será gerada.

Ele aceita muitas sintaxes; em particular, reconhece a sintaxe de data padrão IETF: "Sáb, 12 ago 1995 13:30:00 GMT". Ele também entende as abreviações continentais de fuso horário dos EUA, mas para uso geral, um deslocamento de fuso horário deve ser usado: "Sáb, 12 ago 1995 13:30:00 GMT+0430" (4 horas, 30 minutos a oeste do meridiano greenwich). Se nenhum fuso horário for especificado, o fuso horário local será assumido. GMT e UTC são considerados equivalentes.

A cadeia de caracteres s é processada da esquerda para a direita, procurando dados de interesse. Qualquer material que s esteja dentro dos caracteres de parêntese ( ASCII e ) seja ignorado. Parênteses podem estar aninhados. Caso contrário, os únicos caracteres permitidos dentro s são estes caracteres ASCII: <blockquote>

abcdefghijklmnopqrstuvwxyz
            ABCDEFGHIJKLMNOPQRSTUVWXYZ
            0123456789,+-:/

</blockquote> e caracteres de espaço em branco.

Uma sequência consecutiva de dígitos decimais é tratada como um número decimal:<ul><li>Se um número for precedido ou +- um ano já tiver sido reconhecido, o número será um deslocamento de fuso horário. Se o número for menor que 24, será um deslocamento medido em horas. Caso contrário, ele é considerado um deslocamento em minutos, expresso em formato de tempo de 24 horas sem pontuação. Um anterior - significa um deslocamento para o oeste. Deslocamentos de fuso horário são sempre relativos a UTC (Greenwich). Assim, por exemplo, -5 ocorrer na cadeia de caracteres significaria "cinco horas a oeste de Greenwich" e +0430 significaria "quatro horas e trinta minutos a leste de Greenwich". É permitido que a cadeia de caracteres especifique GMT, UTou UTC redundante, por exemplo, GMT-5 ou utc+0430. <li>O número será considerado um número de ano se uma das seguintes condições for verdadeira: <ul<>li>O número é igual ou maior que 70 e seguido por um espaço, vírgula, barra ou fim da cadeia <de caracteres li>O número é menor que 70, e um mês e um dia do mês já foram reconhecidos</li></ul> Se o número do ano reconhecido for menor que 100, ele é interpretado como um ano abreviado em relação a um século do qual as datas estão dentro de 80 anos antes e 19 anos após o momento em que a classe Date é inicializada. Depois de ajustar o número do ano, 1900 é subtraído dele. Por exemplo, se o ano atual for 1999, os anos na faixa de 19 a 99 serão assumidos como média de 1919 a 1999, enquanto os anos de 0 a 18 serão considerados como média de 2000 a 2018. Observe que isso é ligeiramente diferente da interpretação de anos inferiores a 100 que são usados em java.text.SimpleDateFormat. <li>Se o número é seguido por dois-pontos, ele é considerado como uma hora, a menos que uma hora já tenha sido reconhecida, nesse caso é considerado como um minuto. <li>Se o número for seguido por uma barra, ele será considerado um mês (é reduzido em 1 para produzir um número no intervalo 0 para 11), a menos que um mês já tenha sido reconhecido, nesse caso, ele é considerado um dia do mês. <li>Se o número for seguido por espaço em branco, uma vírgula, um hífen ou o fim da cadeia de caracteres, se uma hora tiver sido reconhecida, mas não um minuto, ele será considerado um minuto; caso contrário, se um minuto tiver sido reconhecido, mas não um segundo, ele será considerado como um segundo; caso contrário, ele será considerado como um dia do mês. </ul>

Uma sequência consecutiva de letras é considerada uma palavra e tratada da seguinte maneira:<ul><li>Uma palavra que corresponde AM, ignorando maiúsculas e minúsculas, é ignorada (mas a análise falhará se uma hora não tiver sido reconhecida ou for menor ou 1 maior que 12). <li>Uma palavra que corresponde PM, ignorando maiúsculas e minúsculas, aumenta 12 a hora (mas a análise falhará se uma hora não tiver sido reconhecida ou for menor 1 ou maior que 12). <li>Qualquer palavra que corresponda a qualquer prefixo de SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, ou SATURDAY, ignorando maiúsculas e minúsculas, é ignorada. Por exemplo, sat, Friday, TUEe Thurs são ignorados. <li>Caso contrário, qualquer palavra que corresponda a qualquer prefixo de JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, ou DECEMBER, ignorando maiúsculas e minúsculas, e considerando-as na ordem fornecida aqui, é reconhecida como especificando um mês e é convertida em um número (0 para 11). Por exemplo, aug, Sept, aprile NOV são reconhecidos como meses. Assim como Ma, que é reconhecido como MARCH, não MAY. <li>Qualquer palavra que corresponda GMT, UT, ou UTC, ignorando maiúsculas e minúsculas, é tratada como referência a UTC. <li>Qualquer palavra que corresponda EST, CST, MST, ou PST, ignorando o caso, é reconhecida como referência ao fuso horário na América do Norte que é cinco, seis, sete ou oito horas a oeste de Greenwich, respectivamente. Qualquer palavra que corresponda EDT, CDT, MDT, ou PDT, ignorando maiúsculas e minúsculas, é reconhecida como se referindo ao mesmo fuso horário, respectivamente, durante o horário de verão.</ul>

Depois que toda a cadeia de caracteres for digitalizada, ela será convertida em um resultado de tempo de duas maneiras. Se um fuso horário ou deslocamento de fuso horário tiver sido reconhecido, o ano, o mês, o dia do mês, a hora, o minuto e o segundo serão interpretados em UTC e, em seguida, o deslocamento de fuso horário será aplicado. Caso contrário, o ano, o mês, o dia do mês, a hora, o minuto e o segundo são interpretados no fuso horário local.

Este membro foi preterido. A partir do JDK versão 1.1, substituído por DateFormat.parse(String s).

Java documentação para java.util.Date.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.

Aplica-se a