Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
calendar

GitHub Action

date-box

0.1.0-beta.1 Pre-release

date-box

calendar

date-box

🗓 Update a pinned gist to contain your anniversaries and countdown days (or hours)

Installation

Copy and paste the following snippet into your .yml file.

              

- name: date-box

uses: kf-liu/[email protected]

Learn more about this action in kf-liu/date-box

Choose a version

image

date-box

🗓 Update a pinned gist to contain your anniversaries and countdown days (or hours)

Node.js CI Update gist with Date


📌 This project is inspired by waka-box and lang-box.

📌 For more pinned-gist projects like this one, check out: https://github.com/matchai/awesome-pinned-gists.

Setup

Prep work

  1. Create a new public GitHub Gist (https://gist.github.com)
  2. Create a token with the gist scope and copy it. (https://github.com/settings/tokens/new)

Project setup

  1. Fork this repo

  2. Edit the environment variable in .github/workflows/schedule.yml:

    • GIST_ID: The ID portion from your gist url: https://gist.github.com/kf-liu/7de2a55824ec5e8a78ebc3c57e4ca82b.
  3. Go to the repo Settings > Secrets

  4. Add the following environment variables:

    • GH_TOKEN: The GitHub token generated above.
    • RECORDS: Your anniversary and countdown days. (The format is below.)

Records format

((cron|moment)( _ (event))? | )|*(cron|moment)( _ (event))?
    |     |     |     |     |
    |     |     |     |     |
    |     |     |     |     +- - - ' | ': record separator
    |     |     |     |
    |     |     |     +- - - - - - (event): what you want to record
    |     |     |
    |     |     +- - - - - - - - - ' _ ': the time and event separator
    |     |
    +- - -+- - - - - - - - - - - - (time): when you want to record

Time format

Currently, two formats are supported: cron (for loop event) and moment (for single event).

  • corn: to schedule a loop event to countdown at specific UTC times using POSIX cron syntax.
    • e.g.
      • 0 0 1 * *
      • 0 0 * * 0
  • moment: to schedule a single event to countdown using moment.
    • e.g.
      • 2022-10-22

One record

One record consists of one time and one event, and thay are connected by _ (a space, an underscore, and a space). Each record will be displayed as a line in your gist.

e.g.

  • 0 0 * * 0,6 _ WEEKEND
  • 0 0 10 * * _ PAYDAY
  • 2022-10-22 _ CREATE THIS REPO
  • 0 0 28 12 * _ MY BIRTHDAY

Of course, event is not required, you can just give the time. (_ is not required as well).

Multiple records

This is the final format of records: Connect a series of records with | (a space, an vertical bar, and a space).

e.g. 0 0 * * 0,6 _ WEEKEND | 0 0 10 * * _ PAYDAY | 2022-10-22 _ CREATE THIS REPO | 0 0 28 12 * _ MY BIRTHDAY.

Ideas to be continue

  • The countdown to the next holiday.

You are the lucky visitor here! Thank you for your 👀attention and ✨star!