> For the complete documentation index, see [llms.txt](https://thebeastuniverse.gitbook.io/beasttokens/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thebeastuniverse.gitbook.io/beasttokens/shop/rotating-shop.md).

# Rotating Shop

#### Cycle Timer :

```yaml
Name: "ExampleShop"
  RotatingItems:
    TimerSettings:
      Debug: true                     # Enable debug logging
      TimerType: CYCLE
      TimeZone: "Europe/Zagreb"       # Time zone for all timers
      Time: "3600"                    # CYCLE need to be set in second  for example 'Time: 600' which is 10 minutes"
```

#### TimeStamp Timer:

```yaml
  Name: "ExampleShop"
  RotatingItems:
    TimerSettings:
      Debug: true                     # Enable debug logging
      TimerType: TIMESTAMP
      TimeZone: "Europe/Zagreb"       # Time zone for all timers
      Time:
        - "20:00"                      # Time only (today or tomorrow)
        - "11:00 PM"                   # 12-hour format
        - "26 11:00 PM"                # Day + time
        - "Mon 20:00"                  # Weekday + time
        - "Monday 08:30 PM"            # Full weekday + 12-hour time
        - "28 Jan 20:00"               # Day + month, this year
        - "05 Dec 14:30"               # Another day + month
        - "21 Jan 08:46:27 AM"         # Day + month + seconds + AM/PM
        - "28 Jan 2025 20:00"          # Full date + 24-hour time
        - "28 Jan 2025 08:30 PM"       # Full date + 12-hour time
        - "2025-11-10 23:33"           # Full date ISO
        - "2025/11/10 11:00 PM"        # Alternative full date format
```

#### **1. Time only**

* `HH:mm` → `20:00`
* `HH:mm:ss` → `20:00:30`
* `hh:mm a` → `08:30 PM`
* `hh:mm:ss a` → `08:30:15 PM`

***

#### **2. Weekday + time**

* `E HH:mm` → `Mon 20:00`
* `E HH:mm:ss` → `Mon 20:00:15`
* `EEEE HH:mm` → `Monday 20:00`
* `EEEE HH:mm:ss` → `Monday 20:00:15`
* `E hh:mm a` → `Mon 08:30 PM`
* `EEEE hh:mm a` → `Monday 08:30 PM`

*(weekday names are English; `E` = short, `EEEE` = full)*

***

#### **3. Day-of-month + time** (newly added)

* `d HH:mm` → `26 20:00`
* `d hh:mm a` → `26 10:00 PM`

*(rolls to next month if the day has already passed)*

***

#### **4. Day + Month + time (no year)**

* `d MMM HH:mm` → `28 Jan 20:00`
* `d MMM HH:mm:ss` → `28 Jan 20:00:15`
* `d MMM hh:mm a` → `28 Jan 08:30 PM`
* `d MMM hh:mm:ss a` → `28 Jan 08:30:15 PM`

*(year is automatically set to current year; rolls to next year if date already passed)*

***

#### **5. Full date with year**

* `d MMM yyyy HH:mm` → `28 Jan 2025 20:00`
* `d MMM yyyy HH:mm:ss` → `28 Jan 2025 20:00:15`
* `d MMM yyyy hh:mm a` → `28 Jan 2025 08:30 PM`
* `d MMM yyyy hh:mm:ss a` → `28 Jan 2025 08:30:15 PM`
* `yyyy-MM-dd HH:mm` → `2025-11-10 23:33`
* `yyyy-MM-dd HH:mm:ss` → `2025-11-10 23:33:15`
* `yyyy/MM/dd HH:mm` → `2025/11/10 23:33`
* `yyyy/MM/dd hh:mm a` → `2025/11/10 11:00 PM`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://thebeastuniverse.gitbook.io/beasttokens/shop/rotating-shop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.