Função DatePart do VBScript

Definição e uso

A função DatePart pode retornar a parte específica da data fornecida.

Comentário:O parâmetro firstdayofweek afeta o cálculo de intervalos usando os símbolos de intervalo 'w' e 'ww'.

Sintaxe

DatePart(interval,date[,firstdayofweek[,firstweekofyear]])
Parâmetros Descrição
interval

Obrigatório. Unidade de intervalo entre date1 e date2 a ser calculada.

Os seguintes valores podem ser usados:

  • yyyy - Ano
  • q - Trimestre
  • m - Mês
  • y - Dia do ano
  • d - Dia
  • w - Dia da semana
  • ww - Semana
  • h - Horas
  • n - Minutos
  • s - Segundos
date Obrigatório. Expressão de data a ser calculada.
firstdayofweek

Opcional. Define o número de dias da semana, ou seja, qual dia da semana é.

Os seguintes valores podem ser usados:

  • 0 = vbUseSystemDayOfWeek - Usa a API de suporte de idioma regional (NLS) para configuração do dia da semana.
  • 1 = vbSunday - Domingo (padrão)
  • 2 = vbMonday - Segunda-feira
  • 3 = vbTuesday - Segunda-feira
  • 4 = vbWednesday - Terça-feira
  • 5 = vbThursday - Quarta-feira
  • 6 = vbFriday - Sexta-feira
  • 7 = vbSaturday - Sábado
firstweekofyear

Opcional. Define a primeira semana do ano.

Os seguintes valores podem ser usados:

  • 0 = vbUseSystem - Usa a API de suporte de idioma regional (NLS).
  • 1 = vbFirstJan1 - Começa pela semana em que 1 de janeiro está localizado (padrão).
  • 2 = vbFirstFourDays - Começa pela primeira semana do ano novo com pelo menos quatro dias.
  • 3 = vbFirstFullWeek - Começa pela primeira semana completa do ano novo.

Exemplo

Exemplo 1

d = #2/10/96 16:45:30#
document.write(DatePart("yyyy",d)) 'Saída: 1996'
document.write(DatePart("m",d)) 'Saída: 2'
document.write(DatePart("d",d)) 'Saída: 10'
document.write(DatePart("h",d)) 'Saída: 16'
document.write(DatePart("n",d)) 'Saída: 45'
document.write(DatePart("s",d)) 'Saída: 30'
document.write(DatePart("q",d)) 'Saída: 1, fevereiro é o 1º trimestre'
document.write(DatePart("y",d)) 'Saída: 41, 10 de fevereiro de 1996 é o 41º dia do ano.'
document.write(DatePart("ww",d)) 'Saída: 6, 10 de fevereiro de 1996 é a 6ª semana do ano 1996.'
document.write(DatePart("w",d)) 'Saída: 7, 10 de fevereiro de 1996 é o 6º semana no 7º dia (sábado).'