Cron Expression Explainer (UTC)

{
  "type": "object",
  "required": [
    "cron_expression"
  ],
  "properties": {
    "num_next": {
      "enum": [
        3,
        5
      ],
      "type": "integer",
      "default": 5,
      "description": "How many upcoming run times to return: 3 or 5 (the default)."
    },
    "cron_expression": {
      "type": "string",
      "description": "A standard five-field cron expression: minute, hour, day of month, month and day of week, separated by spaces."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "is_valid": {
      "type": "boolean"
    },
    "timezone": {
      "type": "string",
      "description": "Always UTC."
    },
    "next_runs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Upcoming run times after the moment of the call, as ISO timestamps in UTC."
    },
    "explanation": {
      "type": "string",
      "description": "Plain-English summary of the schedule."
    },
    "cron_expression": {
      "type": "string",
      "description": "The expression that was explained."
    },
    "field_breakdown": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "minute, hour, day of month, month or day of week."
          },
          "value": {
            "type": "string",
            "description": "The field as written in the expression."
          },
          "meaning": {
            "type": "string",
            "description": "What the field means, in words."
          }
        }
      },
      "description": "One entry per cron field, in order."
    }
  },
  "description": "The explained schedule, as returned after shaping."
}