Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia
Devolve os componentes individuais de um valor de Data/Hora.
Descrição
A Day função retorna o componente dia de um valor de Data/Hora, variando de 1 a 31.
A Month função retorna o componente mês de um valor de Data/Hora, variando de 1 a 12.
A Year função retorna o componente ano de um valor Data/Hora, começando com 1900.
A Hour função retorna o componente de hora de um valor de data/hora, variando de 0 (12:00 AM) a 23 (11:00 PM).
A Minute função retorna o componente minuto de um valor de Data/Hora, variando de 0 a 59.
A Second função retorna o segundo componente de um valor de Data/Hora, variando de 0 a 59.
A Weekday função retorna 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). Você pode especificar um intervalo diferente com um código de função do Microsoft Excel Weekday ou um valor de enumeração StartOfWeek:
| 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
Day( DateTime )
Month( DateTime )
Year( DateTime )
Hour( DateTime )
Minute( DateTime )
Second( DateTime )
- DateTime - Obrigatório. Valor Data/Hora a utilizar.
Weekday( DateTime [, Dia da Semana] )
- 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 |
|---|---|---|
| Year( Agora() ) | Devolve o componente referente ao ano da data e hora atual. | 2015 |
| Month( Agora() ) | Devolve o componente referente ao mês da data e hora atual. | 4 |
| Day( Agora() ) | Devolve o componente referente ao dia da data e hora atual. | 9 |
| Hour( Agora() ) | Devolve o componente referente à hora da data e hora atual. | 15 |
| Minute( Agora() ) | Devolve o componente referente à hora da data e hora atual. | 59 |
| Second( Agora() ) | Devolve o componente de segundos referente à hora e data atual. | 37 |
| Weekday( Agora() ) | 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( Agora(), 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( Agora(), 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 |