Funções Day, Month, Year, Hour, Minute, Second e Weekday no PowerAppsDay, Month, Year, Hour, Minute, Second, and Weekday functions in PowerApps

Devolve os componentes individuais de um valor de Data/Hora.Returns individual components of a Date/Time value.

DescriçãoDescription

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.The Day function returns the day component of a Date/Time value, ranging from 1 to 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.The Month function returns the month component of a Date/Time value, ranging from 1 to 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.The Year function returns the year component of a Date/Time value, starting with 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).The Hour function returns the hour component of a Date/Time value, ranging from 0 (12:00 AM) to 23 (11:00 PM).

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.The Minute function returns the minute component of a Date/Time value, ranging from 0 to 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.The Second function returns the second component of a Date/Time value, ranging from 0 to 59.

A função Weekday devolve o dia da semana de um valor de Data/Hora.The Weekday function returns the weekday of a Date/Time value. Por predefinição, o resultado encontra-se num intervalo entre 1 (domingo) e 7 (sábado).By default, the result ranges from 1 (Sunday) to 7 (Saturday). Pode especificar um intervalo diferente com um valor de enumeração StartOfWeek ou um código de função Weekday do Microsoft Excel:You can specify a different range with an Microsoft Excel Weekday function code or a StartOfWeek enumeration value:

Código do ExcelExcel code Enumeração StartOfWeekStartOfWeek enumeration DescriçãoDescription
1, 171, 17 StartOfWeek.SundayStartOfWeek.Sunday Números entre 1 (domingo) e 7 (sábado).Numbers 1 (Sunday) through 7 (Saturday). Predefinição.Default.
2, 112, 11 StartOfWeek.MondayStartOfWeek.Monday Números entre 1 (segunda-feira) e 7 (domingo).Numbers 1 (Monday) through 7 (Sunday).
33 StartOfWeek.MondayZeroStartOfWeek.MondayZero Números entre 0 (segunda-feira) e 6 (domingo).Numbers 0 (Monday) through 6 (Sunday).
1212 StartOfWeek.TuesdayStartOfWeek.Tuesday Números entre 1 (terça-feira) e 7 (segunda-feira).Numbers 1 (Tuesday) through 7 (Monday).
1313 StartOfWeek.WednesdayStartOfWeek.Wednesday Números entre 1 (quarta-feira) e 7 (terça-feira).Numbers 1 (Wednesday) through 7 (Tuesday).
1414 StartOfWeek.ThursdayStartOfWeek.Thursday Números entre 1 (quinta-feira) e 7 (quarta-feira).Numbers 1 (Thursday) through 7 (Wednesday).
1515 StartOfWeek.FridayStartOfWeek.Friday Números entre 1 (sexta-feira) e 7 (quinta-feira).Numbers 1 (Friday) through 7 (Thursday).
1616 StartOfWeek.SaturdayStartOfWeek.Saturday Números entre 1 (sábado) e 7 (sexta-feira).Numbers 1 (Saturday) through 7 (Friday).

Todas as funções devolvem um número.All functions return a number.

Consulte working with dates and times (trabalhar com datas e horas), para obter mais informações.See working with dates and times for more information.

SintaxeSyntax

Day( DataHora )Day( DateTime )
Month( DataHora )Month( DateTime )
Year( DataHora )Year( DateTime )
Hour( DataHora )Hour( DateTime )
Minute( DataHora )Minute( DateTime )
Second( DataHora )Second( DateTime )

  • DateTime – Necessário.DateTime - Required. Valor Data/Hora a utilizar.Date/Time value to operate on.

Weekday( DataHora [, PrimeiroDiaDaSemana ] )Weekday( DateTime [, WeekdayFirst ] )

  • DataHora – necessário.DateTime - Required. Valor Data/Hora a utilizar.Date/Time value to operate on.
  • PrimeiroDiaDaSemana – opcional.WeekdayFirst - Optional. Código do Excel que especifica o dia em que a semana começa.Excel code specifying which day starts the week. Se tal não for indicado, é utilizado o valor 1 (o primeiro dia da semana é o domingo).If not supplied, 1 (Sunday first) is used.

ExemplosExamples

Para o exemplo seguinte, a hora atual é 15:59:37 de quinta-feira, 9 de abril de 2015.For the following example, the current time is 3:59:37 PM on Thursday, April 9, 2015.

FórmulaFormula DescriçãoDescription ResultadoResult
Year( Now() )Year( Now() ) Devolve o componente referente ao ano da data e hora atual.Returns the year component of the current time and date. 20152015
Month( Now() )Month( Now() ) Devolve o componente referente ao mês da data e hora atual.Returns the month component of the current time and date. 44
Day( Now() )Day( Now() ) Devolve o componente referente ao dia da data e hora atual.Returns the day component of the current time and date. 99
Hour( Now() )Hour( Now() ) Devolve o componente referente à hora da data e hora atual.Returns the hour component of the current time and date. 1515
Minute( Now() )Minute( Now() ) Devolve o componente referente à hora da data e hora atual.Returns the minute component of the current time and date. 5959
Second( Now() )Second( Now() ) Devolve o componente referente à hora da data e hora atual.Returns the minute component of the current time and date. 3737
Weekday( Now() )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.Returns the weekday component of the current time and date, using the default start of the week as Sunday. 55
Weekday( Now(), 14 )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.Returns the weekday component of the current time and date, using an Excel code to specify the start of the week as Thursday. 11
Weekday( Now(), StartOfWeek.Wednesday )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.Returns the weekday component of the current time and date, using a StartOfWeek enumeration to specify the start of the week as Wednesday. 22