Module:Date time/sandbox - Revision history

Gonnym at 14:48, 16 April 2025

2025-04-16T14:48:29Z

← Previous revision		Revision as of 14:48, 16 April 2025
Line 746:		Line 746:
	local get_args = require("Module:Arguments").getArgs		local get_args = require("Module:Arguments").getArgs
	local args = get_args(frame)		local args = get_args(frame)


	-- Validate start date		-- Validate start date
	local start_validation_error = _validate_date_time({args[1], args[2], args[3], df = args.df})		local start_validation_error = _validate_date_time({args[1], args[2], args[3], df = args.df})


	-- Check if end date is "present"		-- Check if end date is "present"
	local is_present = args[4] == "present"		local is_present = args[4] == "present"

Gonnym at 14:32, 16 April 2025

2025-04-16T14:32:47Z

← Previous revision		Revision as of 14:32, 16 April 2025
Line 26:		Line 26:
	---------------		---------------

	local HTML_SPACE = " "		local HTML_SPACE = " " -- Space character for HTML compatibility
	local HTML_NBSP = " "		local HTML_NBSP = " " -- Non-breaking space for HTML
	local DASH = "–"		local DASH = "–" -- En dash for ranges (e.g., year–year)

	-- Error message constants		-- Error message constants

Gonnym at 14:22, 16 April 2025

2025-04-16T14:22:08Z

← Previous revision		Revision as of 14:22, 16 April 2025
Line 548:		Line 548:

	--- Validates that dates are in chronological order when using date ranges.		--- Validates that dates are in chronological order when using date ranges.
	-- ~~@param~~ ~~start_date~~ ~~(table)~~ ~~Table~~ ~~containing~~ ~~start date~~ components		-- Supports partial dates by defaulting missing components (month and day) to 1.
	-- @param ~~end_date~~ (table) Table ~~containing~~ ~~end~~ date components		-- @param start_date (table) Table with start date components (year, month, day)
	-- @~~return~~ ~~boolean~~ ~~true~~ if end date is ~~after~~ ~~start date~~, ~~false otherwise~~		-- @param end_date (table) Table with end date components (year, month, day)
			-- @return boolean true if end_date occurs after or equals start_date, false otherwise
	local function is_date_order_valid(start_date, end_date)		local function is_date_order_valid(start_date, end_date)
	-- Create timestamp for start and end dates
	local start_timestamp = os.time({		local start_timestamp = os.time({
	year = start_date.year,		year = start_date.year,
Line 558:		Line 558:
	day = start_date.day or 1		day = start_date.day or 1
	})		})

	local end_timestamp = os.time({		local end_timestamp = os.time({
	year = end_date.year,		year = end_date.year,
Line 564:		Line 563:
	day = end_date.day or 1		day = end_date.day or 1
	})		})
		⚫	return end_timestamp >= start_timestamp

	-- Compare timestamps
⚫	if end_timestamp < start_timestamp ~~then~~
	return false
	end

	return true
	end		end

Gonnym at 14:20, 16 April 2025

2025-04-16T14:20:21Z

← Previous revision		Revision as of 14:20, 16 April 2025
Line 96:		Line 96:

	--- Pads a number with leading zeros to ensure a minimum of two digits.		--- Pads a number with leading zeros to ensure a minimum of two digits.
	-- @param value (number\|string) The value to pad ~~with leading zeros~~		-- @param value (number\|string) The value to pad
	-- @return string The ~~value~~ padded ~~to at least two digits~~, or nil if input is nil		-- @return string\|nil The padded value, or nil if input is nil
	local function pad_left_zeros(value)		local function pad_left_zeros(value)
	if value ~~== nil~~ then		if not value then
	return nil		return nil
	end		end
			return string.format("%02d", tonumber(value))

	local str = tostring(value)
	return string.rep("0", math.max(0, 2 - #str)) .. str
	end		end

Gonnym at 14:02, 16 April 2025

2025-04-16T14:02:26Z

@@ Line 561: / Line 561: @@
 	})
-	local end_timestamp
+	local end_timestamp = os.time({
-	if end_date.year == "present" then
+		year = end_date.year,
 	-- Compare timestamps
@@ Line 766: / Line 761: @@
 	-- Check if end date is "present"
 	local is_present = args[4] == "present"
 	if start_validation_error or end_validation_error then
@@ Line 781: / Line 786: @@
 		day = pad_left_zeros(args[3])
+	}
 	local end_date = {
-		year = is_present and "9999" or args[4],
+		year = is_present and current_date.year or args[4],
-		month = pad_left_zeros(args[5]),
+		month = is_present and pad_left_zeros(current_date.month) or pad_left_zeros(args[5]),
-		day = pad_left_zeros(args[6]),
+		day = is_present and pad_left_zeros(current_date.day) or pad_left_zeros(args[6]),
 		is_present = is_present  -- Add flag to indicate "present"
+	}
 	if not is_date_order_valid(start_date, end_date) then
 		return generate_error(ERROR_MESSAGES.end_date_before_start_date)
@@ Line 799: / Line 803: @@
 	-- Generate h-calendar markup
 	local start_h_calendar = generate_h_calendar(start_date, "dtstart")
 	return date_range_string .. start_h_calendar .. end_h_calendar
 end

Gonnym at 11:09, 16 April 2025

2025-04-16T11:09:50Z

← Previous revision		Revision as of 11:09, 16 April 2025
Line 2:		Line 2:
	Module:Date time – Date formatting and validation module.		Module:Date time – Date formatting and validation module.

	This module provides functions for validating and formatting dates in ~~templates~~ ~~such~~ as		This module provides functions for validating and formatting dates for the following templates:
	{{Start date}}, {{End date}}, {{Start date and age}}, ~~and~~ {{End date and age}}.		{{Start date}}, {{End date}}, {{Start date and age}}, {{End date and age}}, {{Start and end dates}}.
	It handles:		It handles:
	- Validation of date components (year, month, day)		- Validation of date components (year, month, day)
Line 754:		Line 754:

	--- Generates a formatted date range string with microformat markup.		--- Generates a formatted date range string with microformat markup.
			--- Used by {{Start and end dates}}.
	-- @param frame (table) The MediaWiki frame containing template arguments		-- @param frame (table) The MediaWiki frame containing template arguments
	-- @return string A formatted date range string, or an error message if validation fails		-- @return string A formatted date range string, or an error message if validation fails

Gonnym at 10:55, 16 April 2025

2025-04-16T10:55:20Z

← Previous revision		Revision as of 10:55, 16 April 2025
Line 500:		Line 500:
	-- Format with padding for month and day if needed		-- Format with padding for month and day if needed
	timestamp = string.format("%d-%02d-%02d",		timestamp = string.format("%d-%02d-%02d",
	date_time_values.year,		date_time_values.year,
	date_time_values.month,		date_time_values.month,
	date_time_values.day)		date_time_values.day
			)
	min_magnitude = "days"		min_magnitude = "days"
	elseif date_time_values.month then		elseif date_time_values.month then
	-- Format with padding for month if needed		-- Format with padding for month if needed
	timestamp = string.format("%d-%02d",		timestamp = string.format("%d-%02d",
	date_time_values.year,		date_time_values.year,
	date_time_values.month)		date_time_values.month
			)

	-- Get the current date		-- Get the current date

Gonnym at 10:54, 16 April 2025

2025-04-16T10:54:14Z

← Previous revision		Revision as of 10:54, 16 April 2025
Line 222:		Line 222:
	-- Reject "00" and values with leading zero followed by more than one digit		-- Reject "00" and values with leading zero followed by more than one digit
	return value == "00" or		return value == "00" or
	string.match(value, "^0[0-9][0-9]$") ~= nil or		string.match(value, "^0[0-9][0-9]$") ~= nil or
	string.match(value, "^0[1-9][0-9]") ~= nil		string.match(value, "^0[1-9][0-9]") ~= nil
	end		end

Gonnym at 10:52, 16 April 2025

2025-04-16T10:52:35Z

← Previous revision		Revision as of 10:52, 16 April 2025
Line 814:		Line 814:
	end		end

			-- Exposed for the /testcases
	p.ERROR_MESSAGES = ERROR_MESSAGES		p.ERROR_MESSAGES = ERROR_MESSAGES

Gonnym at 10:51, 16 April 2025

2025-04-16T10:51:47Z

← Previous revision		Revision as of 10:51, 16 April 2025
Line 9:		Line 9:
	- Timezone formatting and validation		- Timezone formatting and validation
	- Generation of appropriate hCalendar microformat markup		- Generation of appropriate hCalendar microformat markup
	- "time-ago" calculations		- "time-ago" calculations for age-related templates

	Design notes:		Design notes:
Line 357:		Line 357:
	end		end

	-- [[MOS:DATERANGE]]		--- Formats a date range according to [[MOS:DATERANGE]] guidelines.
			-- @param start_date (table) Table with start date components (year, month, day)
			-- @param end_date (table) Table with end date components (year, month, day)
			-- @param df (string) Date format flag ("yes" or "y" for day-month-year format)
			-- @return string Formatted date range string following the style guidelines
	local function format_date_range_string(start_date, end_date, df)		local function format_date_range_string(start_date, end_date, df)
	-- Ensure start year is provided		-- Ensure start year is provided
Line 543:		Line 547:
	--------------------------		--------------------------

			--- Validates that dates are in chronological order when using date ranges.
			-- @param start_date (table) Table containing start date components
			-- @param end_date (table) Table containing end date components
			-- @return boolean true if end date is after start date, false otherwise
	local function is_date_order_valid(start_date, end_date)		local function is_date_order_valid(start_date, end_date)
	-- Create timestamp for start and end dates		-- Create timestamp for start and end dates