---
title: Effective Dating
description: There are some aspects of the Doshii API that are only valid during certain times of the day, or certain days in the year (e.g. location operating hours, menu pricing, item availability, etc). We have
---

[Skip to content](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#main-content)

English

Show submenu for translations

Doshii Connect Pty Ltd

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to Doshii Connect Pty Ltd

 Go to Doshii Connect Pty Ltd

 Help for Partners

- There are no suggestions because the search field is empty.

1. [Help for Partners](https://support.doshii.com/developer-support?hsLang=en)
2. [API concepts](https://support.doshii.com/developer-support/api-concepts?hsLang=en)

# Effective Dating

There are some aspects of the Doshii API that are only valid during certain times of the day, or certain days in the year (e.g. location operating hours, menu pricing, item availability, etc). We have termed this logic, *Effective Dating*, and will use the below structure across the various API endpoints to define the dates and times that the entity comes into effect. 

The structure is broken up into a list of policies, each of those policies define a period of time.

[Policy](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#h_01GJYCHZG3ZT32Y3A266VQ2EBA)

[- PolicyDate Object](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#h_01GJYCJ7WQ141NEYM7T72G81E2)

[Policy Properties](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#h_01GJYCJS0Y0PBHNMSW2H18PC6R)

[Example](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#h_01GJYCK21E0F5VPKP1SVWSGBJA)

[- More Examples](https://support.doshii.com/developer-support/hc/en-us/articles/360013787294-effective-dating#h_01GJYCKBYDCN8A609A7K6DJPFY)

 

 Policy

All root-level properties are optional. An optional root-level property without a value is omitted.

```
[{   status: <String* (open|closed)>,   dates: [<PolicyDate>],   time: {       from: <String* (HH:mm)>,       to: <String* (HH:mm)>   },   daysOfWeek: [<String (mon|tue|wed|thu|fri|sat|sun)>],   effective: {       from: <String (yyyy-mm-dd)>,       to: <String (yyyy-mm-dd)>   }}]
```

### PolicyDate Object

```
[{   day: <Number (1-31)>,   month: <Number (1-12)>,   year: <Number>}]
```

 Policy Properties

 

 Example

A restaurant could have the following trading hours:

Its full payload would be:

```
[{
    status: 'closed',
    daysOfWeek: ['mon']
}, {
    status: 'open',
    time: {
        from: '11:30',
        to: '14:30'
    },
    daysOfWeek: ['tue', 'wed', 'thu', 'fri', 'sat', 'sun']
}, {
    status: 'open',
    time: {
        from: '17:30',
        to: '21:00'
    },
    daysOfWeek: ['tue', 'wed', 'thu', 'sun']
}, {
    status: 'open',
    time: {
        from: '17:30',
        to: '21:30'
    },
    daysOfWeek: ['fri', 'sat']
}, {
    status: 'closed',
    dates: [{
        day: 1,
        month: 1
    }]
}, {
    status: 'closed',
    dates: [{
        day: 24,
        month: 12
    }, {
        day: 26,
        month: 12
    }]
}]
```

### More Examples

**Example 1: Opening times from Jan 1 next year**

```
[{
    status: 'open',
    time: {
        from: '11:00',
        to: '19:00'
    },
    effective: {
        from: '2019-01-01'
    }
}]
```

**Example 2: Closed every Monday**

```
[{
    status: 'closed',
    daysOfWeek: ['mon']
}]
```

**Example 3: Closed every Xmas Day**

```
[{
    status: 'closed',
    dates: [{
        day: 25,
        month: 12
    }]
}]
```

**Example 4: Closed for lunch everyday**

```
[{
    status: 'closed',
    time: {
        from: '12:00',
        to: '13:00'
    }
}]
```

**Example 5: Longer hours for week night trading**

```
[[{
    status: 'open',
    time: {
        from: '11:00',
        to: '21:00'
    },
    daysOfWeek: ['mon', 'tue', 'wed', 'thu', 'fri']
}]
```

**Example 6: Xmas**

Open till midnight the day before xmas and closed for xmas.

```
[{
    status: 'open',
    dates: [{
        day: 23,
        month: 12
    }],
    time: {
        from: '11:00',
        to: '23:59'
    }
}, {
    status: 'closed',
    dates: [{
        day: 24,
        month: 12
    }]
}]
```

- [API concepts](https://support.doshii.com/developer-support/api-concepts?hsLang=en)
- [Members](https://support.doshii.com/developer-support/members?hsLang=en)
- [Model](https://support.doshii.com/developer-support/model?hsLang=en)
- [FAQ - Developers](https://support.doshii.com/developer-support/faq-developers?hsLang=en)
- [Resources](https://support.doshii.com/developer-support/resources?hsLang=en)
- [Orders](https://support.doshii.com/developer-support/orders?hsLang=en)
- [Rewards](https://support.doshii.com/developer-support/rewards?hsLang=en)
- [Check-ins](https://support.doshii.com/developer-support/check-ins?hsLang=en)
- [Getting started - App partners](https://support.doshii.com/developer-support/getting-started-app-partners?hsLang=en)
- [Employees](https://support.doshii.com/developer-support/employees?hsLang=en)
- [Getting started - Doshii Dashboard](https://support.doshii.com/developer-support/getting-started-doshii-dashboard?hsLang=en)
- [Quick start for developers](https://support.doshii.com/developer-support/quick-start-for-developers?hsLang=en)
- [Onboarding](https://support.doshii.com/developer-support/onboarding?hsLang=en)
- [Location](https://support.doshii.com/developer-support/location?hsLang=en)
- [All App Partners Event](https://support.doshii.com/developer-support/all-app-partners-event?hsLang=en)
- [Menus](https://support.doshii.com/developer-support/menus?hsLang=en)
- [Loyalty / Checkins](https://support.doshii.com/developer-support/loyalty-checkins?hsLang=en)
- [WebSocket - App partners](https://support.doshii.com/developer-support/websocket-app-partners?hsLang=en)
- [All POS vendor events](https://support.doshii.com/developer-support/all-pos-vendor-events?hsLang=en)
- [Loyalty / Gift Cards](https://support.doshii.com/developer-support/loyalty-gift-cards?hsLang=en)
- [Devices](https://support.doshii.com/developer-support/devices?hsLang=en)
- [Tables](https://support.doshii.com/developer-support/tables?hsLang=en)
- [Workflows](https://support.doshii.com/developer-support/workflows?hsLang=en)
- [FAQ - Doshii Dashboard](https://support.doshii.com/developer-support/faq-doshii-dashboard?hsLang=en)
- [Bookings](https://support.doshii.com/developer-support/bookings?hsLang=en)
- [Transactions](https://support.doshii.com/developer-support/transactions?hsLang=en)
- [Webhooks](https://support.doshii.com/developer-support/webhooks?hsLang=en#main-content)

    - [App Partners](https://support.doshii.com/developer-support/webhooks?hsLang=en#app-partners)
    - [POS Vendors](https://support.doshii.com/developer-support/webhooks?hsLang=en#pos-vendors)
- [App Partner Guide](https://support.doshii.com/developer-support/app-partner-guide?hsLang=en)
- [Authentication](https://support.doshii.com/developer-support/authentication?hsLang=en)
- [Getting started - POS vendors](https://support.doshii.com/developer-support/getting-started-pos-vendors?hsLang=en)
- [Ordering](https://support.doshii.com/developer-support/ordering?hsLang=en)
- [Reservations](https://support.doshii.com/developer-support/reservations?hsLang=en)
- [Pilot](https://support.doshii.com/developer-support/pilot?hsLang=en)
- [Bulk data](https://support.doshii.com/developer-support/bulk-data?hsLang=en)
- [Playbooks](https://support.doshii.com/developer-support/playbooks?hsLang=en)
- [Rejection codes](https://support.doshii.com/developer-support/rejection-codes?hsLang=en)
- [Getting started](https://support.doshii.com/developer-support/getting-started?hsLang=en)
- [WebSocket - POS partners](https://support.doshii.com/developer-support/websocket-pos-partners?hsLang=en)
- [Events - App partners](https://support.doshii.com/developer-support/events-app-partners?hsLang=en)
- [Service channels](https://support.doshii.com/developer-support/service-channels?hsLang=en)
- [Events](https://support.doshii.com/developer-support/events?hsLang=en)
- [Concepts](https://support.doshii.com/developer-support/concepts?hsLang=en)
- [Apps](https://support.doshii.com/developer-support/apps?hsLang=en)

# Doshii Connect Pty Ltd

Doshii Connect Pty Ltd Help Center

Copyright © 2026, Doshii Connect Pty Ltd