Date Range Expander

Date Range Expander

A plugin for Obsidian that allows you to quickly insert a range of dates into your notes. Perfect for planning, journaling, or creating date-based content.

Features

• Insert a sequence of dates using either an end date or duration
• Format dates according to your preferences
• Create wiki-linked dates automatically
• Optional callout formatting for date ranges
• Flexible file creation options for wiki-linked dates

How to Use

1. Open the command palette (Ctrl/Cmd + P)
2. Search for "Date Range Expander"
3. Enter your date range details in the modal:
   • Start date (format: YYYYMMDD)
   • Choose either:
     • End date (format: YYYYMMDD), or
     • Duration (1-100 Days/Weeks/Months)
   • Toggle whether to wrap dates in a callout

The plugin will then insert your date range using your configured format settings.

Settings

Date Formatting

• Output date format: Format for the inserted dates

  • Default: YYYY.MM.DD
  • Example: 2024.03.15

• Friendly date format: Format for displaying dates in a more readable way in certains locations like the callout and alert boxes.

  • Default: DDD D MMM YYYY
  • Supports:
    • D: Single digit day (1-31)
    • DD: Two digit day with leading zero (01-31)
    • DDD: Three letter day abbreviation (Mon, Tue, etc.)
    • DDDD: Full day name (Monday, Tuesday, etc.)
    • M: Single digit month (1-12)
    • MM: Two digit month with leading zero (01-12)
    • MMM: Three letter month abbreviation (Jan, Feb, etc.)
    • MMMM: Full month name (January, February, etc.)
    • Y: Single digit year (0-9)
    • YY: Two digit year (00-99)
    • YYY: Three digit year (000-999)
    • YYYY: Full four digit year (0000-9999)
  • Examples:
    • DDD D MMM YYYY -> Fri 8 Mar 2024
    • MMMM D, YYYY -> March 8, 2024
    • DD/MM/YY -> 08/03/24
    • DDDD, MMMM D, YYYY -> Friday, March 8, 2024
    • YYYY-MM-DD -> 2024-03-08

• Date separator: Character(s) used to separate dates in the sequence

  • Default: ", "
  • Example: 2024.03.15, 2024.03.16, 2024.03.17

Wiki Links

• Create wiki links: Toggle whether dates should be inserted as wiki links
  • When enabled: [[2024.03.15]]
  • When disabled: 2024.03.15

File Creation Options

When wiki links are enabled, you can choose how to handle non-existent date files:

• Do not create: Only create the wiki links, don't create actual files
• Create in same folder: Automatically create date files in the same folder as the current note
• Create in custom folder: Create date files in a specified folder
  • If selected, you can set a custom folder path (e.g., "Daily Notes")

Modal Options

Start Date

• Enter the beginning date in YYYYMMDD format
• Example: 20240315 for March 15, 2024

Range Type

Choose between two ways to specify your date range:

1. End Date

   • Enter the final date in YYYYMMDD format
   • The plugin will create a sequence from start to end date (inclusive of both dates)

2. Duration

   • Specify a number (1-100)
   • Choose the unit: Days, Weeks, or Months
   • The plugin will create a sequence starting from the start date for the specified duration

Callout Option

• Toggle "Add to callout" to wrap your date sequence in a collapsible callout
• Useful for organizing long date sequences

Examples

1. Simple date range:

2024.03.15, 2024.03.16, 2024.03.17

2. Wiki-linked dates:

[[2024.03.15]], [[2024.03.16]], [[2024.03.17]]

3. Dates in a callout:

> [!SUMMARY]- Date range: Fri 15 Mar 2024 to Sun 17 Mar 2024
> [[2024.03.15]], [[2024.03.16]], [[2024.03.17]] 

Say Thanks 🙏

If you find this plugin helpful, then maybe... toss a coin to your witcher developer:

Your support helps maintain and improve the plugin! 😊