Funções Day, Month, Year, Hour, Minute, Second e Weekday
Aplica-se a:
Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI
Devolve os componentes individuais de um valor de Data/Hora.
Descrição
A função Day devolve o componente referente ao dia de um valor de Data/Hora, que corresponde a um número entre 1 e 31.
A função Month devolve o componente referente ao mês de um valor de Data/Hora, que corresponde a um número entre 1 e 12.
A função Year devolve o componente referente ao ano de um valor de Data/Hora, que corresponde a um número a partir de 1900.
A função Hour devolve o componente referente à hora de um valor de Data/Hora, que corresponde a um número entre 0 (00:00) e 23 (23:00).
A função Minute devolve o componente referente aos minutos de um valor de Data/Hora, que corresponde a um número entre 0 e 59.
A função Second devolve o componente referente aos segundos de um valor de Data/Hora, que corresponde a um número entre 0 e 59.
A função Weekday devolve o dia da semana de um valor de Data/Hora. Por predefinição, o resultado encontra-se num intervalo entre 1 (domingo) e 7 (sábado). Pode especificar um intervalo diferente com um valor de enumeração StartOfWeek ou um código de função Weekday do Microsoft Excel:
| Código do Excel | Enumeração StartOfWeek | Descrição |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | Números entre 1 (domingo) e 7 (sábado). Predefinição. |
| 2, 11 | StartOfWeek.Monday | Números entre 1 (segunda-feira) e 7 (domingo). |
| 3 | StartOfWeek.MondayZero | Números entre 0 (segunda-feira) e 6 (domingo). |
| 12 | StartOfWeek.Tuesday | Números entre 1 (terça-feira) e 7 (segunda-feira). |
| 13 | StartOfWeek.Wednesday | Números entre 1 (quarta-feira) e 7 (terça-feira). |
| 14 | StartOfWeek.Thursday | Números entre 1 (quinta-feira) e 7 (quarta-feira). |
| 15 | StartOfWeek.Friday | Números entre 1 (sexta-feira) e 7 (quinta-feira). |
| 16 | StartOfWeek.Saturday | Números entre 1 (sábado) e 7 (sexta-feira). |
Todas as funções devolvem um número.
Consulte Trabalhar com datas e horas, para obter mais informações.
Sintaxe
Day( DataHora )
Month( DataHora )
Year( DateTime )
Hour( DataHora )
Minute( DataHora )
Second( DataHora )
- DateTime – Necessário. Valor Data/Hora a utilizar.
Weekday( DataHora [, PrimeiroDiaDaSemana ] )
- DateTime – Necessário. Valor Data/Hora a utilizar.
- WeekdayFirst – Opcional. Código do Excel que especifica o dia em que a semana começa. Se tal não for indicado, é utilizado o valor 1 (o primeiro dia da semana é o domingo).
Exemplos
Para o exemplo seguinte, a hora atual é 15:59:37 de quinta-feira, 9 de abril de 2015.
| Fórmula | Descrição | Resultado |
|---|---|---|
| Year( Now() ) | Devolve o componente referente ao ano da data e hora atual. | 2015 |
| Month( Now() ) | Devolve o componente referente ao mês da data e hora atual. | 4 |
| Day( Now() ) | Devolve o componente referente ao dia da data e hora atual. | 9 |
| Hour( Now() ) | Devolve o componente referente à hora da data e hora atual. | 15 |
| Minute( Now() ) | Devolve o componente referente à hora da data e hora atual. | 59 |
| Second( Now() ) | Devolve o componente de segundos referente à hora e data atual. | 37 |
| Weekday( Now() ) | Devolve o componente referente ao dia da semana da data e hora atual, ao utilizar o domingo como o início da semana predefinido. | 5 |
| Weekday( Now(), 14 ) | Devolve o componente referente ao dia da semana da data e hora atual e utiliza um código do Excel para especificar que o início da semana é à quinta-feira. | 1 |
| Weekday( Now(), StartOfWeek.Wednesday ) | Devolve o componente referente ao dia da semana da data e hora atual e utiliza uma enumeração StartOfWeek para especificar que o início da semana ocorre à quarta-feira. | 2 |