Método Parse

Artigo
08/01/2011

Analisa uma seqüência de caracteres que contém uma data e retorna o número de milissegundos entre a data e a meia-noite, 1º de janeiro de 1970.

function parse(dateVal : {String | System.DateTime} ) : Number

Argumentos

dateVal
Obrigatório. Uma seqüência contendo uma data em um formato como "5 de janeiro de 1996 08: 47: 00" ou um valor VT_DATE recuperado de um objeto ActiveX ® ou outro objeto.

Comentários

O Analisar método retorna um valor integer representando o número de milissegundos entre meia-noite, 1º de janeiro de 1970 e a data fornecida na dateVal.

O Analisar método é um método estático do Date objeto. Porque é um método estático, ele é chamado, conforme mostrado no exemplo a seguir, em vez de chamado como um método de uma criada Date objeto.

var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)

As regras a seguir controlam o que o Analisar método pode ser analisado com êxito:

Datas abreviadas podem usar um "/" ou "-" separador de data, mas deve seguir o formato dia/mês/ano, por exemplo "20/7/96".
Datas longas do formulário "De 1995 de 10 de julho" podem ser fornecidas com o ano, mês e dia em qualquer ordem e o ano no formulário 2 ou 4 dígitos. Se você usar o formulário de 2 dígitos, o ano deve ser maior ou igual a 70.
Qualquer texto dentro dos parênteses é tratado como um comentário. Esses parênteses podem ser aninhados.
Vírgulas e espaços são tratados como delimitadores. Vários delimitadores são permitidos.
Os nomes de mês e dia devem ter dois ou mais caracteres. Dois nomes de caracteres que não são exclusivos são resolvidos como a última correspondência. Por exemplo, "Ju" é determinado como julho, não a junho.
Estabelecido o dia da semana é ignorado se ele é incorreto o restante da data fornecida. Por exemplo, "De 1996 9 de novembro terça-feira" é aceito e analisada, mesmo que essa data realmente cair em uma sexta-feira. Resultante Date objeto contém "De 1996 9 de novembro sexta-feira".
JScript lida com todos os fusos horários padrão, bem como a hora Universal Coordenada (UTC) e Greenwich Mean Time (GMT).
Dois-pontos separam horas, minutos e segundos, embora todos não precisam ser especificados. " 10: ","10: 11"e" 10: 11:12 " são válidos.
Se for usado o relógio de 24 horas, é um erro para especificar "PM" para posteriormente a noon de 12 horas. Por exemplo, "23: 15 PM" é um erro.
Uma seqüência de caracteres que contém uma data inválida é um erro. Por exemplo, uma seqüência de caracteres contendo dois anos ou dois meses é um erro.

Exemplo

O exemplo a seguir ilustra o uso de Analisar método. Fornecer a função com uma data e a função retornará a diferença entre a data 1 de 1 de 1970 e fornecida:

function GetTimeTest(testdate){
   var s, t;                    //Declare variables.
   var MinMilli = 1000 * 60;       //Initialize variables.
   var HrMilli = MinMilli * 60;
   var DyMilli = HrMilli * 24;
   t = Date.parse(testdate);       //Parse testdate.
   s = "There are "                //Create return string.
   s += Math.round(Math.abs(t / DyMilli)) + " days "
   s += "between " + testdate + " and 1/1/70";
   return(s);                      //Return results.
}