Skip to content
Airspaces Schedule Examples

Airspaces Schedule Examples

Andi Lamprecht Andi Lamprecht ·· 3 min read· Accepted
ADR-0045 · Author: Sybil Melton · Date: 2025-02-07 · Products: platform
Originally 0040 airspaces_schedule_examples (v7) · Source on Confluence ↗

Case 1 - permanent

Option 1 - Atlas choice:

{
  "schedules": [
    {
      "start_datetime": null,
      "end_datetime": null
    }
  ]
}

Alternatives Considered

Option 2 - null value indicates permanent schedule:

{
  "schedules": null
}

Option 3 - use the “permanent” statement:

{
  "schedules": "permanent"
}

Option 4 - use the “permanent” statement but match the general schema:

{
  "schedules": [
    {
      "start_datetime": "permanent",
      "end_datetime": "permanent"
    }
  ]
}

Option 5 - generate start datetime as first Jan and end datetime as last Dec:

{
  "schedules": [
    {
      "start_datetime": "2023-01-01T00:00:00Z",
      "end_datetime": "2023-12-31T23:59:59Z"
    }
  ]
}

Case 2 - permanent but with start date

e.g. permanent from 2023-08-03T15:00:00Z

Option 1 - Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023-08-03T15:00:00Z",
      "end_datetime": null
    }
  ]
}

Alternatives Considered

Option 2 - use the “permanent” statement, match the general schema:

{
  "schedules": [
    {
      "start_datetime": "2023-08-03T15:00:00Z",
      "end_datetime": "permanent"
    }
  ]
}

Option 3 - generate end datetime as last Dec:

{
  "schedules": [
    {
      "start_datetime": "2023-08-03T15:00:00Z",
      "end_datetime": "2023-12-31T23:59:59Z"
    }
  ]
}

Case 3 - from datetime to datetime

e.g. from 2023‐01‐01T12:26:04Z to 2023‐07‐07T17:26:04Z

Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023‐01‐01T12:26:04Z",
      "end_datetime": "2023‐07‐07T17:26:04Z"
    }
  ]
}

Case 4 - constant operating hours

e.g. each day from 06:00 to 09:00 and from 17:00 to 21:00

Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023-01-01T00:00:00Z",
      "end_datetime": "2023-12-31T23:59:59Z",
      "timesheet": [
        {
          "day": "any",
          "start_time": "06:00:00Z",
          "end_time": "09:00:00Z"
        },
        {
          "day": "any",
          "start_time": "17:00:00Z",
          "end_time": "21:00:00Z"
        }
      ]
    }
  ]
}

Case 5 - different operating hours for specific week days

e.g. for Monday-Friday from 07:00 to 21:00, for Saturday-Sunday from 07:00 to 17:00

Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023-01-01T00:00:00Z",
      "end_datetime": "2023-12-31T23:59:59Z",
      "timesheet": [
        {
          "day": "Mon",
          "start_time": "07:00:00Z",
          "end_time": "21:00:00Z"
        },
        {
          "day": "Tue",
          "start_time": "07:00:00Z",
          "end_time": "21:00:00Z"
        },
        {
          "day": "Wed",
          "start_time": "07:00:00Z",
          "end_time": "21:00:00Z"
        },
        {
          "day": "Thu",
          "start_time": "07:00:00Z",
          "end_time": "21:00:00Z"
        },
        {
          "day": "Fri",
          "start_time": "07:00:00Z",
          "end_time": "21:00:00Z"
        },
        {
          "day": "Sat",
          "start_time": "07:00:00Z",
          "end_time": "17:00:00Z"
        },
        {
          "day": "Sun",
          "start_time": "07:00:00Z",
          "end_time": "17:00:00Z"
        }
      ]
    }
  ]
}

Case 6 - operating hours from datetime to datetime

e.g. from 2023‐07‐01T11:00:00Z to 2023‐09‐07T09:00:00Z from 11:00 to 09:00

Option 1 - Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023‐07‐01T11:00:00Z",
      "end_datetime": "2023‐09‐07T09:00:00Z",
      "timesheet": [
        {
          "day": "any",
          "start_time": "00:00:00Z",
          "end_time": "09:00:00Z"
        },
        {
          "day": "any",
          "start_time": "11:00:00Z",
          "end_time": "23:59:00Z"
        }
      ]
    }
  ]
}

Alternatives Considered

Option 2 - separate the first and last day to avoid confusion between datetime and timesheet:

{
  "schedules": [
    {
      "start_datetime": "2023‐07‐01T11:00:00Z",
      "end_datetime": "2023‐07‐01T23:59:00Z"
    },
    {
      "start_datetime": "2023‐07‐02T00:00:00Z",
      "end_datetime": "2023‐09‐06T23:59:59Z",
      "timesheet": [
        {
          "day": "any",
          "start_time": "00:00:00Z",
          "end_time": "09:00:00Z"
        },
        {
          "day": "any",
          "start_time": "11:00:00Z",
          "end_time": "23:59:00Z"
        }
      ]
    },
    {
      "start_datetime": "2023‐09‐07T00:00:00Z",
      "end_datetime": "2023‐09‐07T09:00:00Z"
    }
  ]
}

Case 7 - different operating hours for specific dates

e.g. for 2023-08-25 from 07:00 to 17:00, for 2023-08-26 from 08:00 to 16:00

Atlas choice:

{
  "schedules": [
    {
      "start_datetime": "2023-08-25T07:00:00Z",
      "end_datetime": "2023-08-25T17:00:00Z"
    },
    {
      "start_datetime": "2023-08-26T08:00:00Z",
      "end_datetime": "2023-08-26T16:00:00Z"
    }
  ]
}
Last updated on