![]() ![]() |
A classe estática DateTimeSpan fornece funções para determinar a quantidade de tempo entre duas datas ou horários e para aumentar ou reduzir intervalos de tempo. Ela fornece um conjunto de funções para trabalhar com diferenças entre duas datas. Como os intervalos de data são apenas números, o aplicativo pode utilizar correspondências normais entre eles: multiplicação, divisão, adição, subtração e assim por diante. Essa classe é estática. O aplicativo não pode criar instâncias de classe.
Esta função retorna uma nova data, que é a soma da adição de um dado número de anos, meses e dias para a data de início. Os meses podem ser maiores que 12 e os dias podem ser maiores que o número de dias em um mês. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, adicione os anos. Depois, utilizando a data resultante, adicione os meses. Em seguida, utilizando a data resultante, adicione os dias.
Ao adicionar um mês, a data resultante pode não ser válida. Por exemplo, adicionar um mês para 31 de janeiro produziria a data inválida 31 de fevereiro. A função ajusta a data para que seja válida, assim, se o ano não for um ano bissexto, fevereiro terá 28 dias e a data resultante será 3 de março.
Qualquer um dos argumentos de anos, meses ou dias poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.
Qualquer um dos argumentos de anos, meses ou dias poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido subtraída da data base.
DateTimeSpan.addDate( startDate, years, months, days )
Uma data que resulta da adição de anos, meses e dias na data de início.
var startDate = date.parse( "2004-12-31" ); var endDate; endDate = DateTimeSpan( startDate, 1, 0, 0 ); // retorna 2005-12-31 endDate = DateTimeSpan( startDate, 0, 1, 0 ); // retorna 2005-1-31 endDate = DateTimeSpan( startDate, 0, 0, 1 ); // retorna 2005-1-1 endDate = DateTimeSpan( startDate, 1, 1, 1 ); // retorna 2005-3-4
Função DateTimeSpan.addTime
Função DateTimeSpan.subDate
Esta função retorna uma nova data, que é a soma da adição de um dado número de horas, minutos e segundos para a data de início. As horas podem ser maiores que 24 e os minutos e segundos podem ser maiores que 60. O efeito da rede é como se houvesse operações diferentes. Primeiramente, adicione as horas. Depois, utilizando a data resultante, adicione os minutos. Em seguida, utilizando a data resultante, adicione os segundos.
Qualquer um dos argumentos de horas, minutos ou segundos poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.
Qualquer um dos argumentos de horas, minutos ou segundos poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido subtraída da data base.
DateTimeSpan.addTime( startDate, hours, minutes, seconds )
Uma data que resulta da adição de horas, minutos e segundos na data de início.
Função DateTimeSpan.addDate
Função DateTimeSpan.subTime
Retorna o número de dias entre duas datas. Um dia é definido como uma alteração do calendário. Assim, 23:59:59 de 27 de fevereiro até meia-noite de 28 de fevereiro será um dia, bem como meia-noite de 27 de fevereiro até 23:59:59 de 28 de fevereiro.
DateTimeSpan.days( startDate, endDate )
O número de retornos de dias entre duas datas.
Esta função retorna o número de horas completas entre dois horários. Uma hora completa é um intervalo definido a partir de um dado minuto de hora em hora, para o mesmo minuto na próxima hora. Por exemplo, 1:23:00 a 2:23:00 é uma hora, enquanto 1:23:00 a 2:22:59 não é uma hora completa.
DateTimeSpan.hours( startDate, endDate )
O número de horas completas entre duas datas.
Esta função retorna o número de minutos completos entre dois horários. Um minuto completo é um intervalo definido a partir de um dado segundo de um minuto, para o mesmo segundo no próximo minuto. Por exemplo, 1:23:00 a 1:24:00 é um minuto, enquanto 1:23:00 a 1:22:59 não é um minuto completo.
DateTimeSpan.minutes( startDate, endDate )
O número de minutos completos entre duas datas.
Esta função retorna o número de meses completos entre duas datas. Um mês completo é um intervalo de tempo definido a partir do último dia de um mês até o último dia do mês seguinte. Por exemplo, 28 de fevereiro até 28 de março é um mês, enquanto 28 de fevereiro a 26 de março não é um mês completo.
DateTimeSpan.months( startDate, endDate )
Retorna o número completo de meses entre duas datas.
Esta função retorna o número de segundos entre dois horários.
DateTimeSpan.seconds( startDate, endDate )
O número de minutos completos entre duas datas.
Esta função retorna uma nova data, que é o resultado da subtração de um dado número de anos, meses e dias da data de início. Os meses podem ser maiores que 12 e os dias podem ser maiores que o número de dias em um mês. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, subtraia os anos. Depois, utilizando a data resultante, subtraia os meses. Em seguida, utilizando a data resultante, subtraia os dias.
Ao subtrair um mês, a data resultante pode não ser válida. Por exemplo, subtrair um mês de 30 de março produziria a data inválida 30 de fevereiro. A função ajusta a data para que seja válida, ajustando a data ao último dia válido no mês. Nesse caso, se o ano não for um ano bissexto, a data seria ajustada ao dia 28 de fevereiro.
Qualquer um dos argumentos de anos, meses ou dias poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.
Qualquer um dos argumentos de anos, meses ou dias poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido adicionada à data base.
DateTimeSpan.subDate( startDate, years, months, days )
Uma data que resulta da subtração de anos, meses e dias a partir da data de início.
Função DateTimeSpan.addDate
Função DateTimeSpan.subTime
Esta função retorna uma nova data, que é o resultado da subtração de um dado número de horas, minutos e segundos a partir da data de início. As horas podem ser maiores que 24 e os minutos e segundos podem ser maiores que 60. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, subtraia as horas. Depois, utilizando a data resultante, subtraia os minutos. Em seguida, utilizando a data resultante, subtraia os segundos.
Qualquer um dos argumentos de horas, minutos ou segundos poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.
Qualquer um dos argumentos de horas, minutos ou segundos poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido adicionada à data base.
DateTimeSpan.subTime( startDate, hours, minutes, seconds )
Uma data que resulta da subtração de horas, minutos e segundos a partir da data de início.
Função DateTimeSpan.addTime
Função DateTimeSpan.subDate
Esta função computa o número de anos completos entre duas datas. Um ano completo é definido como iniciando a partir de um dado mês, dia e hora em um ano até o mesmo mês, dia e hora do ano seguinte. Por causa dos anos bissextos, um ano completo, às vezes, incluirá 365 dias; outras vezes, 366 dias.
Se um dos argumentos for diferente de uma data, uma exceção será lançada. Se um dos argumentos for nulo, o resultado também será nulo.
DateTimeSpan.years( startDate, endDate )
O número de anos completos entre duas datas.
![]() ![]() |