# Time Zone Conversion

<h2>1. Time Zone Conversion Target Object</h2>
  There are 3 APIs involved in time zone handling:
  <ul>
    <li>
      <b> <a href="https://api-docs.mykeeta.com/apis/opendelivery/merchantendpoints/getMerchant">Get information of a Merchant</a> </b>
      <ul>
        <li>services.serviceHours</li>
        <li>availabilities</li>
      <ul>
    </li>
    <li>
      <b><a href="https://api-docs.mykeeta.com/apis/opendelivery/merchantendpoints/merchantUpdate">New Merchant Update Notification</a></b> 
      <ul>
        <li>services.serviceHours</li>
        <li>availabilities</li>
      <ul>
    </li>
    <li>
      <b><a href="https://api-docs.mykeeta.com/apis/opendelivery/merchantendpoints/merchantStatus">Get Merchant Status and Service Hours</a></b> 
      <ul>
        <li>services.serviceHours</li>
      <ul>
    </li>
  </ul>

  <h2> 2. Time Zone Conversion Rules</h2>
  (1) All time-related fields in the documentation are transmitted in the <B>UTC+0</B> time zone.</br>
  (2) The value in <B>timePeriods</B> should always conform to the rule: <B>endTime > startTime</B>.</br>
  (3) If the time spans a day after conversion to the UTC+0 time zone, it should be split into two parts.</br>
  (4) 24:00 should be transmitted as: 23:59:00.000Z.</br>

  <h2> 3. Time Zone Conversion Examples</h2>
  
  Take Brazil's official time zone <B>UTC-3</B> as an example.
  <h3> 3.1 [ data + timePeriod ] combination scenario</h3>
  <h4> (1) The conversion to UTC+0 will not cross the day</h4>
  If the local time is: **2024-04-07 08:00-20:00**, the format transmitted in the API should be (after converting to UTC+0):
  
  ```
  [
    {
      "date": "2021-04-07",
      "timePeriods": {
          "startTime": "11:00:00.000Z",
          "endTime": "23:00:00.000Z"
      }
    }
  ]
  ```

  <h4> (2) The conversion to UTC+0 will cross the day</h4>
  If the local time is: **2024-04-07 10:00-22:00**, the format transmitted in the API should be (after converting to UTC+0):

  ```
  [
    {
      "date": "2021-04-07",
      "timePeriods": {
          "startTime": "13:00:00.000Z",
          "endTime": "23:59:00.000Z"
      }
    },
    {
      "date": "2021-04-08",
      "timePeriods": {
          "startTime": "00:00:00.000Z",
          "endTime": "01:00:00.000Z"
      }
    }
  ]
  ```

  <h3> 3.2 [ dayOfWeek + timePeriod ] combination scenario</h3>
  <h4> (1) The conversion to UTC+0 will not cross the day</h4>
  If the local time is: **Monday & Tuesday 08:00-20:00**, the format transmitted in the API should be (after converting to UTC+0):
  
  ```
  [
    {
      "dayOfWeek": [
          "MONDAY",
          "TUESDAY"
      ],
      "timePeriods": {
          "startTime": "11:00:00.000Z",
          "endTime": "23:00:00.000Z"
      }
    }
  ]
  ```

  <h4> (2) The conversion to UTC+0 will cross the day</h4>
  If the local time is: **Monday & Tuesday 10:00-22:00**, the format transmitted in the API should be (after converting to UTC+0):

  ```
  [
    {
      "dayOfWeek": [
          "MONDAY"
      ],
      "timePeriods": {
          "startTime": "11:00:00.000Z",
          "endTime": "23:59:00.000Z"
      }
    },
    {
      "dayOfWeek": [
          "TUESDAY"
      ],
      "timePeriods": {
          "startTime": "00:00:00.000Z",
          "endTime": "01:00:00.000Z"
      }
    },
    {
      "dayOfWeek": [
          "TUESDAY"
      ],
      "timePeriods": {
          "startTime": "11:00:00.000Z",
          "endTime": "23:59:00.000Z"
      }
    },
    {
      "dayOfWeek": [
          "WEDNESDAY"
      ],
      "timePeriods": {
          "startTime": "00:00:00.000Z",
          "endTime": "01:00:00.000Z"
      }
    }
  ]
  ```

  Finally merge into:
  ```
  [
    {
      "dayOfWeek": [
          "MONDAY",
          "TUESDAY"
      ],
      "timePeriods": {
          "startTime": "11:00:00.000Z",
          "endTime": "23:59:00.000Z"
      }
    },
    {
      "dayOfWeek": [
          "TUESDAY",
          "WEDNESDAY"
      ],
      "timePeriods": {
          "startTime": "00:00:00.000Z",
          "endTime": "01:00:00.000Z"
      }
    }
  ]
  ```