Funciones WeekNum e ISOWeekNum
Se aplica a:
Aplicaciones de Canvas Aplicaciones basadas en modelos Power Pages Dataverse Columnas de fórmula
Devuelve el número de semana de una fecha determinada.
Description
Utilice lsa funciones WeekNum e ISOWeekNum para determinar el número de semana de una fecha.
Estas funciones difieren en cómo determinan la primera semana del año (semana 1):
WeekNum utiliza la semana que contiene el 1 de enero como la primera semana del año. El resultado de esta función puede oscilar entre 1 y 54.
ISOWeekNum utiliza la semana que contiene el primer jueves del año como la primera semana del año. Sigue la definición de fecha y hora de la norma ISO 8601 para la numeración de la semana. El resultado de esta función puede oscilar entre 1 y 53. Es posible que se devuelvan 52 o 53 para los primeros días de enero ya que las fechas podrían pertenecer a la última semana del año anterior.
Utilice el segundo parámetro para WeekNum para especificar qué día comienza una semana. Puede proporcionar un número de código de Excel o utilizar la enumeración StartOfWeek:
| Código de Excel | Enumeración de StartOfWeek | Descripción |
|---|---|---|
| 1, 17 | Inicio de semana.domingo | La semana comienza el domingo. Predeterminado. |
| 2, 11 | Inicio de semana.lunes | La semana comienza el lunes. |
| 12 | Inicio de semana.martes | La semana comienza el martes. |
| 13 | Inicio de semana.miércoles | La semana comienza el miércoles. |
| 14 | Inicio de semana.jueves | La semana comienza el jueves. |
| 15 | Inicio de semana.viernes | La semana comienza el viernes. |
| 16 | Inicio de semana. Sábado | La semana comienza el sábado. |
ISOWeekNum siempre usa el lunes como el inicio de la semana. En Excel, la función WeekNum admite un código de adición 21 que no se admite aquí; use ISOWeekNum en su lugar.
Si pasa un solo número a estas funciones, el valor que se devuelve es un resultado único. Si pasa una tabla de una sola columna que contiene números, el valor que se muestra es una tabla de resultados de una sola columna, un resultado para cada registro en la tabla del argumento. Si tiene una tabla con varias columnas, puede convertirla en una tabla de una sola columna, como se describe en cómo trabajar con tablas.
Sintaxis
NúmeroDeSemana(FechaHora [, InicioDeSemana ])
- DateTime - Obligatorio. Valor de fecha y hora con el que operar.
- StartOfWeek - Opcional. Código de Excel o enumeración StartOfWeek que determina qué día comienza la semana.
NúmSemanaISO(FechaHora)
- DateTime - Obligatorio. Valor de fecha y hora con el que operar. La semana siempre empieza el lunes.
Ejemplos
Primera y última semana natural de 2021
| Fecha | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Viernes,1de enero de2021 | 1 | 53 | 1 |
| Sábado,2de enero de2021 | 1 | 53 | 1 |
| Domingo,3de enero de2021 | 2 | 53 | 1 |
| Lunes,4de enero de2021 | 2 | 1 | 1 |
| Martes,5de enero de2021 | 2 | 1 | 1 |
| Miércoles,6de enero de2021 | 2 | 1 | 2 |
| Jueves,7de enero de2021 | 2 | 1 | 2 |
| Sábado,25de diciembre de2021 | 52 | 51 | 52 |
| Domingo,26de diciembre de2021 | 53 | 51 | 52 |
| Lunes,27de diciembre de2021 | 53 | 52 | 52 |
| Martes,28de diciembre de2021 | 53 | 52 | 52 |
| Miércoles,29de diciembre de2021 | 53 | 52 | 53 |
| Jueves,30de diciembre de2021 | 53 | 52 | 53 |
| Viernes,31de diciembre de2021 | 53 | 52 | 53 |