📅 API de Fechas

API para realizar operaciones con fechas de manera sencilla y eficiente.

Sumar Días

GET
/api/date/add-days

Suma un número específico de días a una fecha.

Parámetros de consulta:

  • date (string, requerido): Fecha en formato YYYY-MM-DD
  • days (number, requerido): Número de días a sumar
  • format (string, opcional): Formato personalizado de salida
  • utc (string, opcional): Offset UTC en formato ±HH (ejemplo: +02 o -05)

Respuesta exitosa (200 OK):

{
    "operation": "add_days",
    "input": {
        "date": "2024-05-01",
        "days": 5,
        "format": "YYYY-MM-DD",
        "utc": "+02"
    },
    "result": "2024-05-06"
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/add-days?date=2024-05-01&days=5&utc=+02"

Restar Días

GET
/api/date/subtract-days

Resta un número específico de días a una fecha.

Parámetros de consulta:

  • date (string, requerido): Fecha en formato YYYY-MM-DD
  • days (number, requerido): Número de días a restar
  • format (string, opcional): Formato personalizado de salida
  • utc (string, opcional): Offset UTC en formato ±HH (ejemplo: +02 o -05)

Respuesta exitosa (200 OK):

{
    "operation": "subtract_days",
    "input": {
        "date": "2024-05-01",
        "days": 5,
        "format": "YYYY-MM-DD",
        "utc": "+02"
    },
    "result": "2024-04-26"
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/subtract-days?date=2024-05-01&days=5&utc=+02"

Diferencia entre Fechas

GET
/api/date/difference

Calcula la diferencia en días entre dos fechas.

Parámetros de consulta:

  • date1 (string, requerido): Primera fecha en formato YYYY-MM-DD
  • date2 (string, requerido): Segunda fecha en formato YYYY-MM-DD
  • utc1 (string, opcional): Offset UTC para la primera fecha
  • utc2 (string, opcional): Offset UTC para la segunda fecha

Respuesta exitosa (200 OK):

{
    "operation": "difference_days",
    "input": {
        "date1": "2024-05-01",
        "date2": "2024-05-06",
        "utc1": "+02",
        "utc2": "+02"
    },
    "result": 5
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/difference?date1=2024-05-01&date2=2024-05-06"

Fecha y Hora Actual

GET
/api/date/now

Obtiene la fecha y hora actual del servidor con información detallada.

Parámetros de consulta:

  • format (string, opcional): Formato personalizado de salida
  • utc (string, opcional): Offset UTC en formato ±HH (ejemplo: +02 o -05)

Respuesta exitosa (200 OK):

{
    "operation": "current_datetime",
    "input": {
        "format": null,
        "utc": "+02"
    },
    "result": {
        "formatted": "2024-05-01 15:30:45",
        "date": "2024-05-01",
        "time": "15:30:45",
        "dayOfWeek": "Wednesday",
        "dayOfYear": 122,
        "weekOfYear": 18,
        "month": "May",
        "year": 2024,
        "isLeapYear": true,
        "quarter": 2,
        "timezone": "UTC+02",
        "unix": 1714563045,
        "iso": "2024-05-01T13:30:45.000Z"
    }
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/now?utc=+02"

Verificar Fin de Semana

GET
/api/date/is-weekend

Verifica si una fecha cae en fin de semana.

Parámetros de consulta:

  • date (string, requerido): Fecha en formato YYYY-MM-DD
  • utc (string, opcional): Offset UTC en formato ±HH (ejemplo: +02 o -05)

Respuesta exitosa (200 OK):

{
    "operation": "is_weekend",
    "input": {
        "date": "2024-05-04",
        "utc": "+02"
    },
    "result": true
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/is-weekend?date=2024-05-04"

Día de la Semana

GET
/api/date/day-of-week

Obtiene el día de la semana para una fecha específica.

Parámetros de consulta:

  • date (string, requerido): Fecha en formato YYYY-MM-DD
  • format (string, opcional): Formato personalizado de salida
  • utc (string, opcional): Offset UTC en formato ±HH (ejemplo: +02 o -05)

Respuesta exitosa (200 OK):

{
    "operation": "day_of_week",
    "input": {
        "date": "2024-05-01",
        "format": "dddd",
        "utc": "+02"
    },
    "result": "Wednesday"
}

Ejemplo de uso:

curl -X GET "https://testio.dev/api/date/day-of-week?date=2024-05-01"
Probar Herramienta