Date::M...nfigFile(3)

✨ NAME ✨

Date::Manip::ConfigFile β€” bestie, it's literally just a sample config file. That's the whole vibe. πŸ’…

Oh and real quick, this page lives in the User Contributed Perl Documentation section, so you already know it's the good stuff. ✨


🌸 DESCRIPTION 🌸

Okay so. Date::Manip is highkey configurable β€” like, options for days. And a whole bunch of those options can be set in a config file, which is what this doc is here for: it hands you a sample config file to copy and vibe with. 🫢

The config file is split into three sections:

  1. Config variables β€” described more fully in the Date::Manip::Config document.
  2. The holiday definition section β€” described more fully in the Date::Manip::Holidays document.
  3. The event definition section β€” also described more fully in the Date::Manip::Holidays document.

So like, two of the three sections are covered by the same doc. Efficient. Love that for us. πŸ’–


πŸŽ€ SAMPLE CONFIG FILE πŸŽ€

Heads up, bestie: the sample below works for newer versions of Date::Manip. Some of the config variables may change, or be deprecated, and some might straight up not work with earlier versions of Date::Manip. So it is strongly suggested that you check out the documentation for the version of Date::Manip you are actually using, to confirm any of the config variables you want to include. No cap β€” version drift is real. 😭

################################
# CONFIG VARIABLES
################################
# See Date::Manip::Config man page for a description of all
# config variables.

# To include configuration information from additional
# config files:

ConfigFile              = /path/to/another/config/file
ConfigFile              = /path/to/another/config/file2

# For handling other languages

Language                = English
DateFormat              = US
Encoding                =

# Set the current timezone:

SetDate                 = now,America/New_York

# Set the work work

WorkWeekBeg             = 1
WorkWeekEnd             = 5
WorkDay24Hr             = 0
WorkDayBeg              = 08:00
WorkDayEnd              = 17:00
TomorrowFirst           = 1

# Misc. variables

YYtoYYYY                = 89
FirstDay                = 1
Use_POSIX_Printf        = 0
Week1ofYear             = jan4
Printable               = 0
DefaultTime             = midnight
RecurRange              = none

################################
# HOLIDAYS
################################
# See the Date::Manip::Holidays man page for a description of
# this section.
*HOLIDAYS

# FEDERAL HOLIDAYS
##################

# You can express New Year's Day as the actual day (Jan 1)
# or the observed day (Jan 1 or the nearest week day).
# You can't include BOTH because once a day is marked as
# a holiday, a second definition will treat it the same
# as a weekend and choose another day to assign the holiday
# to (so there would be two days designated as New Years).

# Jan 1                         = New Year's Day
1*1:0:1:0:0:0*DWD               = New Year's Day (observed)

# Two different ways to defined MLK day

third Monday in Jan             = Martin Luther King Jr.'s Birthday
# 1*1:3:1:0:0:0                 = Martin Luther King Jr.'s Birthday

# Observed by federal employees in Washington D.C.

# Jan 20                        = Inauguration day
third Monday in Feb             = Washington's Birthday
last Monday in May              = Memorial Day
1st Monday in Sep               = Labor Day
second Monday in Oct            = Columbus Day

# Jul 4                         = Independence Day
1*7:0:4:0:0:0*DWD               = Independence Day

# 11/11                         = Veterans Day
1*11:0:11:0:0:0*DWD             = Veteran's Day

# To define both Thanksgiving and the day after, use the
# following two lines:

fourth Thu in Nov               = Thanksgiving
1*11:4:4:0:0:0*FD1              = Day after Thanksgiving

# Dec 25                        = Christmas
1*12:0:25:0:0:0*DWD             = Christmas

# SAMPLE HOLIDAYS
##################

# You can define a one-time-only holiday by specifying
# the day and year.

6/2/1999                        = A special test holiday for 1999

################################
# EVENTS
################################
# See the Date::Manip::Holidays man page for a description of
# this section.
*EVENTS

2000-02-01               = Event01
2000-02-01-12:00:00      = Event02
02-01                    = Event03
02-01 12:00:00           = Event04
1*2:0:3:13:00:00         = Event05

2000-02-05 10:00:00 ; 2000-02-05 10:59:59 = Event06
2000-02-05          ; 2000-02-06          = Event07
02-05               ; 02-06               = Event08

2000-02-07 10:00:00 ; 0:0:0:0:3:0:0       = Event09
02-07 10:00:00      ; 0:0:0:0:4:0:0       = Event10
1*2:0:7:10:00:00    ; 0:0:0:0:5:0:0       = Event11

πŸ‘‘ SEE ALSO πŸ‘‘

  • Date::Manip β€” main module documentation. The mothership. Go read her. πŸ¦‹

πŸ“œ LICENSE πŸ“œ

This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Slay, open source. πŸ’š


πŸ’… AUTHOR πŸ’…

Sullivan Beck (<https://github.com/SBECK-github/>) β€” the icon, the moment, the main character. πŸ‘‘


Okay that's the whole page, bestie!! 🌈 This was perl v5.42.3, dated 2026-09-01 β€” and yeah, the manual page name got chopped to Date::M...nfigFile(3) on the way out, which is genuinely giving ✨mysterious✨ but you and I both know what it means. Byeeee, go define some holidays! πŸŽ€πŸ’–βœ¨

πŸ“¦ where this page comes from