Timestamp de inicio de año
Encuentra el timestamp Unix del 1 de enero a las 00:00:00 UTC del año actual, más límites de fecha cercanos habituales.
Inicio del año actual
Las marcas de tiempo de inicio de año son útiles para agregaciones del año hasta la fecha, resúmenes anuales, informes de facturación y fixtures de prueba que necesitan un límite de calendario estable.
Límite UTC
El valor de inicio de año en esta página es el 1 de enero a las 00:00:00 UTC. Si tu lógica de negocio usa una zona horaria de negocio local, convierte el límite antes de escribir filtros de base de datos.
Cuándo son útiles las marcas de tiempo de inicio de año
El inicio del año es un ancla común para informes y datos de prueba. Úsalo para construir paneles del año hasta la fecha, rangos de facturación anual, cálculos de retención y fixtures que deban actualizarse automáticamente al cambiar el calendario. Combínalo con el límite del año siguiente al consultar periodos anuales completos.
- Usa yearStart como límite inferior para informes del año hasta la fecha
- Usa nextYearStart como límite superior exclusivo para un año natural completo
- Usa UTC cuando el informe abarque varias regiones o servicios de backend
- Usa una zona horaria de negocio solo cuando reglas contables o de producto definan el año localmente
Verificar el valor de inicio de año
Convierte la marca de tiempo de nuevo a una fecha UTC y confirma que indica el 1 de enero a las 00:00:00 para el año actual. Si tu informe usa un año fiscal o una zona horaria de negocio local, genera un límite separado para esa regla en lugar de reutilizar el valor del año natural UTC. Mantén la definición elegida junto a la consulta para que los futuros responsables sepan por qué se eligió el límite y qué zona horaria se usó.