Funções Day, Month, Year, Hour, Minute, Second e Weekday
Aplica-se a:
Colunas Dataverse de fórmula de aplicativos de tela Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo
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.Sábado | 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
Dia( DateTime )
Mês( DateTime )
Ano ( DateTime )
Hora( DateTime )
Minuto( DateTime )
Segundo( DateTime )
- DateTime - Obrigatório. Valor Data/Hora a utilizar.
Dia da semana( DateTime [, WeekdayFirst ] )
- DateTime - Obrigató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 |
|---|---|---|
| Ano( Agora() ) | Devolve o componente referente ao ano da data e hora atual. | 2015 |
| Mês( Agora() ) | Devolve o componente referente ao mês da data e hora atual. | 4 |
| Dia( Agora() ) | Devolve o componente referente ao dia da data e hora atual. | 9 |
| Hora( Agora() ) | Devolve o componente referente à hora da data e hora atual. | 15 |
| Minuto( Agora() ) | Devolve o componente referente à hora da data e hora atual. | 59 |
| Segundo( Agora() ) | Devolve o componente de segundos referente à hora e data atual. | 37 |
| Dia da semana( 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 |
| Dia da semana( 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 |
| Dia da semana( 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 |