DatePart foi explicado no manual de referência ASP (VBScript), mas sua explicação do primeiro parâmetro é muito escrita e enganosa. Vamos explicar novamente.
A sintaxe de DatePart é DatePart(intervalo, data), que é usada para obter uma determinada parte da data.
intervalo
aaaa: ano em data
m: mês na data
d: dia na data
h: hora na data
n: minuto na data
s: segundos na data
q: Em qual trimestre do ano a data está localizada, por exemplo, 2009-6-29 está no 2º trimestre.
y: a data está no dia do ano, por exemplo, 2009-6-29 está no 180º dia.
w: a data está no dia da semana (domingo é o primeiro dia por padrão), por exemplo, 2009-6-29 está no 2º dia.
ww: a data está localizada na semana do ano, por exemplo, 2009-6-29 está localizada na 27ª semana.
DatePart(intervalo, data[, primeiro dia da semana [, primeira semana do ano]])
A sintaxe da função DatePart possui os seguintes parâmetros:
Descrição do parâmetro
intervalo é necessário. Uma expressão de string que representa o intervalo de tempo a ser retornado. Consulte a seção Configurações para valores.
data é necessária. A expressão de data a ser avaliada.
primeiro dia da semana opcional. Uma constante que especifica o primeiro dia da semana. Se não for especificado, o padrão será domingo. Consulte a seção Configurações para valores.
primeira semana do ano Opcional. Constante que especifica a primeira semana do ano. Se não for especificado, o padrão será a semana de 1º de janeiro. Consulte a seção Configurações para valores.
O parâmetro de intervalo pode ser definido com os seguintes valores:
Descrição da configuração
aaaa ano
q trimestre
m mês
y o número de dias em um ano
dia d
w Dia da semana
semanas
h horas
m minutos
segundos
O parâmetro firstdayofweek pode ter os seguintes valores:
Descrição do valor constante
vbUseSystem 0 Use a configuração da API National Language Support (NLS).
vbSunday 1 Sunday (padrão)
vbSegunda-feira 2 Segunda-feira
vbTerça-feira 3 Terça-feira
vbQuarta-feira, 4 Quarta-feira
vbQuinta-feira, 5 Quinta-feira
vbSexta-feira, 6 Sexta-feira
vbSábado 7 Sábado
O parâmetro firstweekofyear pode ter os seguintes valores:
Descrição do valor constante
vbUseSystem 0 Use a configuração da API National Language Support (NLS).
vbFirstJan1 1 Começa na semana de 1º de janeiro (padrão).
vbFirstFourDays 2 começa com a primeira semana do ano novo que tem pelo menos quatro dias.
vbFirstFullWeek 3 começa com a primeira semana completa do ano novo (não entre anos).
ilustrar
A função DatePart calcula uma data e retorna um intervalo de tempo especificado. Por exemplo, use DatePart para calcular o dia da semana ou a hora atual de um determinado dia.
O parâmetro firstdayofweek afeta os cálculos usando os símbolos de intervalo "w" e "ww".
Se a data for uma data literal, o ano especificado se tornará uma parte fixa da data. Mas se a data estiver entre aspas (" ") e o ano for omitido, o ano atual será inserido toda vez que a expressão de data for avaliada no código. Isso torna possível escrever código de programa que funcione em anos diferentes.