Objeto de data

Artigo
08/25/2010

Um objeto que permite o armazenamento básico e a recuperação de data e hora.Há duas formas do Date construtor.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Argumentos

dateVal
Opcional.Se um valor numérico, dateVal representa o número de milissegundos em time universal coordenado entre a data especificada e a meia-noite de 1 º de janeiro de 1970. Se uma seqüência de caracteres, dateVal é analisada para de acordo com as regras a analisar método.The dateVal também pode ser um valor de data .NET.
year
Obrigatório.O ano completo, por exemplo, 1976 (não 76).
mês
Obrigatório.O mês sistema autônomo um número inteiro entre 0 e 11 (janeiro a dezembro).
date
Obrigatório.A data sistema autônomo um número inteiro entre 1 e 31.
hours
Opcional.Deve ser fornecido se minutos é fornecido.Um inteiro de 0 a 23 (meia-noite às 11 h) que especifica a hora.
minutos
Opcional.Deve ser fornecido se segundos é fornecido.Um inteiro de 0 a 59 que especifica os minutos.
segundos
Opcional.Deve ser fornecido se milissegundos é fornecido.Um inteiro de 0 a 59 que especifica os segundos.
ms
Opcional.Um inteiro de 0 a 999 que especifica o milissegundos.

Comentários

A Date objeto contém um número que representa uma instância particular no momento de dentro de um milissegundo. Se o valor de um argumento for maior do que o intervalo ou é um número negativo, outros valores armazenados são modificados da mesma forma.Por exemplo, se você especificar 150 segundos, o JScript redefine esse número sistema autônomo dois minutos e 30 segundos.

Se o número for NaN, o objeto não representa uma instância específica no time. Se você passar sem parâmetros para o Date construtor, ele é inicializado para a time corrente (UTC). Uma variável do tipo Date deve ser inicializada antes de usá-lo.

O intervalo de datas que podem ser representados em um Date o objeto é aproximadamente 285,616 anos em ambos os lados do 1 º de janeiro de 1970.

The Date objeto tem dois métodos estático, analisar and UTC, que são chamados sem criar um Date objeto.

Se o Date construtor é chamado sem a novo operador, o Date objeto retornado contém a data corrente independentemente dos argumentos passados para o construtor.

Observação:
O Date objeto interopera com o .NET estrutura sistema.DateTimetipo de dados de no JScript.No entanto, outros idiomas CLS (Common linguagem Specification) não podem usar o Date objeto porque JScript somente fornece o objeto; não é derivado de um tipo .NET estrutura. Conseqüentemente, quando o tipo-anotar os parâmetros e tipos de retorno dos métodos compatível compatível com CLS, certifique-se de usar o sistema.DateTime tipo de dados, em vez do Date objeto. No entanto, você pode usar o Date objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

O Date objeto interopera com o .NET estrutura sistema.DateTimetipo de dados de no JScript.No entanto, outros idiomas CLS (Common linguagem Specification) não podem usar o Date objeto porque JScript somente fornece o objeto; não é derivado de um tipo .NET estrutura. Conseqüentemente, quando o tipo-anotar os parâmetros e tipos de retorno dos métodos compatível compatível com CLS, certifique-se de usar o sistema.DateTime tipo de dados, em vez do Date objeto. No entanto, você pode usar o Date objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

Exemplo

O exemplo a seguir utiliza o Date objeto.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Se este programa foi executado em 26 de janeiro de 1992, a saída seria: