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

Retorna os componentes individuais de um valor de data/hora.Returns individual components of a Date/Time value.

DescriçãoDescription

A função Day retorna o componente do dia de um valor de data/hora, variando de 1 a 31.The Day function returns the day component of a Date/Time value, ranging from 1 to 31.

A função Month retorna o componente do mês de um valor de data/hora, variando de 1 a 12.The Month function returns the month component of a Date/Time value, ranging from 1 to 12.

A função Year retorna o componente do ano de um valor de data/hora, começando com 1900.The Year function returns the year component of a Date/Time value, starting with 1900.

A função Hour retorna o componente da hora de um valor de data/hora, variando de 0 (12:00 AM) a 23 (11:00PM).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 retorna o componente do minuto de um valor de data/hora, variando de 0 a 59.The Minute function returns the minute component of a Date/Time value, ranging from 0 to 59.

A função Second retorna o componente do segundo de um valor de data/hora, variando de 0 a 59.The Second function returns the second component of a Date/Time value, ranging from 0 to 59.

A função Weekday retorna o dia da semana de um valor de data/hora.The Weekday function returns the weekday of a Date/Time value. Por padrão, o resultado varia de 1 (domingo) a 7 (sábado).By default, the result ranges from 1 (Sunday) to 7 (Saturday). Você pode especificar um intervalo diferente com um código da função Weekday do Microsoft Excel ou um valor de enumeração StartOfWeek: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 de 1 (domingo) a 7 (sábado).Numbers 1 (Sunday) through 7 (Saturday). Padrão.Default.
2, 112, 11 StartOfWeek.MondayStartOfWeek.Monday Números de 1 (segunda-feira) a 7 (domingo).Numbers 1 (Monday) through 7 (Sunday).
33 StartOfWeek.MondayZeroStartOfWeek.MondayZero Números de 0 (segunda-feira) a 6 (domingo).Numbers 0 (Monday) through 6 (Sunday).
1212 StartOfWeek.TuesdayStartOfWeek.Tuesday Números de 1 (terça-feira) a 7 (segunda-feira).Numbers 1 (Tuesday) through 7 (Monday).
1313 StartOfWeek.WednesdayStartOfWeek.Wednesday Números de 1 (quarta-feira) a 7 (terça-feira).Numbers 1 (Wednesday) through 7 (Tuesday).
1414 StartOfWeek.ThursdayStartOfWeek.Thursday Números de 1 (quinta-feira) a 7 (quarta-feira).Numbers 1 (Thursday) through 7 (Wednesday).
1515 StartOfWeek.FridayStartOfWeek.Friday Números de 1 (sexta-feira) a 7 (quinta-feira).Numbers 1 (Friday) through 7 (Thursday).
1616 StartOfWeek.SaturdayStartOfWeek.Saturday Números de 1 (sábado) a 7 (sexta-feira).Numbers 1 (Saturday) through 7 (Friday).

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

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

SintaxeSyntax

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

  • DateTime - obrigatório.DateTime - Required. Valor de data/hora no qual operar.Date/Time value to operate on.

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

  • DateTime - obrigatório.DateTime - Required. Valor de data/hora no qual operar.Date/Time value to operate on.
  • WeekdayFirst - Opcional.WeekdayFirst - Optional. Código do Excel que especifica em qual dia inicia a semana.Excel code specifying which day starts the week. Se não for fornecido, 1 (domingo primeiro) é usado.If not supplied, 1 (Sunday first) is used.

ExemplosExamples

Para o exemplo a seguir, a hora atual é 3:59:37 PM na 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() ) Retorna o componente do ano da data e hora atual.Returns the year component of the current time and date. 20152015
Month( Now() )Month( Now() ) Retorna o componente do mês da data e hora atual.Returns the month component of the current time and date. 44
Day( Now() )Day( Now() ) Retorna o componente do dia da data e hora atual.Returns the day component of the current time and date. 99
Hour( Now() )Hour( Now() ) Retorna o componente da hora da data e hora atual.Returns the hour component of the current time and date. 1515
Minute( Now() )Minute( Now() ) Retorna o componente do minuto da data e hora atual.Returns the minute component of the current time and date. 5959
Second( Now() )Second( Now() ) Retorna o componente do minuto da data e hora atual.Returns the minute component of the current time and date. 3737
Weekday( Now() )Weekday( Now() ) Retorna o componente do dia da semana da data e hora atuais, usando o padrão de início da semana como domingo.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 ) Retorna o componente do dia da semana da data e hora atuais, usando um código do Excel para especificar o início da semana como 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 ) Retorna o componente do dia da semana da data e hora atuais, usando uma enumeração StartOfWeek para especificar o início da semana como 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