Module:Time/sandbox - Revision history

Trappist the monk at 17:40, 4 May 2025

2025-05-04T17:40:57Z

@@ Line 564: / Line 564: @@
 	local utc_offset;
 			end
 			end
 		end
 	end

Gonnym: sync with live

2025-05-04T09:29:07Z

sync with live

← Previous revision		Revision as of 09:29, 4 May 2025
Line 528:		Line 528:
	mimics templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.		mimics templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.

	{{#invoke:Time~~/sandbox~~\|~~tz_offset~~\|<tz>}} – for a stand-alone invoke		{{#invoke:Time\|utc_offset\|<tz>}} – for a stand-alone invoke
	{{#invoke:Time~~/sandbox~~\|~~tz_offset~~}} – for an invoke in a template (<tz> is first positional parameter in the template call)		{{#invoke:Time\|utc_offset}} – for an invoke in a template (<tz> is first positional parameter in the template call)

	where <tz> is a timezone abbreviation known to Module:Time/data		where <tz> is a timezone abbreviation known to Module:Time/data

	returns a UTC offset string suitable for use with the {{#time:}} parser function:		returns a UTC offset string suitable for use with the {{#time:}} parser function:
	{{#time:H:i \| {{#invoke:Time~~/sandbox~~\|~~tz_offset~~\|MST}} }}		{{#time:H:i \| {{#invoke:Time\|utc_offset\|MST}} }}
	{{#time:H:i \| {{UTC_offset\|MST}} }}		{{#time:H:i \| {{UTC_offset\|MST}} }}

Trappist the monk at 21:35, 3 May 2025

2025-05-03T21:35:47Z

← Previous revision		Revision as of 21:35, 3 May 2025
Line 610:		Line 610:
	return {		return {
	time = time,		time = time,
	tz_offset = utc_offset,
	utc_offset = utc_offset,		utc_offset = utc_offset,
	}		}

Trappist the monk at 21:34, 3 May 2025

2025-05-03T21:34:04Z

← Previous revision		Revision as of 21:34, 3 May 2025
Line 522:		Line 522:


	--[[--------------------------< T Z _ O F F S E T >------------------------------------------------------------		--[[--------------------------< U T C _ O F F S E T >----------------------------------------------------------

	~~Mimics~~ templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.		implements {{UTC offset}}

			mimics templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.

	{{#invoke:Time/sandbox\|tz_offset\|<tz>}} – for a stand-alone invoke		{{#invoke:Time/sandbox\|tz_offset\|<tz>}} – for a stand-alone invoke
Line 531:		Line 533:
	where <tz> is a timezone abbreviation known to Module:Time/data		where <tz> is a timezone abbreviation known to Module:Time/data

	returns a UTC offset string suitable for use with the {{#time:}} parser function		returns a UTC offset string suitable for use with the {{#time:}} parser function:
			{{#time:H:i \| {{#invoke:Time/sandbox\|tz_offset\|MST}} }}
			{{#time:H:i \| {{UTC_offset\|MST}} }}

	]]		]]

	local function ~~tz_offset~~ (frame)		local function utc_offset (frame)
	local function apply_dst_ajdust (offset) -- local function to adjust standard time to daylight time; called when adjustment is needed		local function apply_dst_ajdust (offset) -- local function to adjust standard time to daylight time; called when adjustment is needed
	local hours, minutes = offset:match ('^(%-?%d%d):(%d%d)'); -- extract signed hours and minutes from specified offset		local hours, minutes = offset:match ('^(%-?%d%d):(%d%d)'); -- extract signed hours and minutes from specified offset
Line 606:		Line 610:
	return {		return {
	time = time,		time = time,
	tz_offset = ~~tz_offset~~,		tz_offset = utc_offset,
			utc_offset = utc_offset,
	}		}

Trappist the monk at 17:42, 2 May 2025

2025-05-02T17:42:08Z

← Previous revision		Revision as of 17:42, 2 May 2025
Line 25:		Line 25:
	]]		]]

	local function substitute (msg, ~~args~~)		local function substitute (msg, args_t)
	return ~~args~~ and mw.message.newRawMessage (msg, ~~args~~):plain() or msg;		return args_t and mw.message.newRawMessage (msg, args_t):plain() or msg;
	end		end

Line 33:		Line 33:

	create an error message		create an error message
			<args_t> is a sequence where [1] is template name and [2] is substituted error message

	]]		]]

	local function error_msg (~~msg, arg~~)		local function error_msg (args_t)
	return substitute (cfg.err_msg, ~~substitute (cfg.err_text[msg], arg)~~)		return substitute (cfg.err_msg, args_t);
	end		end

Line 377:		Line 377:
	if not ((DF_cust_a and DF_cust_p) or -- DF_cust_a xor DF_cust_p		if not ((DF_cust_a and DF_cust_p) or -- DF_cust_a xor DF_cust_p
	(not DF_cust_a and not DF_cust_p))then		(not DF_cust_a and not DF_cust_p))then
	return error_msg ('bad_df_pair'); -- both are required		return error_msg ({'Time', cfg.err_text['bad_df_pair']}); -- both are required
	end		end

Line 392:		Line 392:
	local s, t = mw.ustring.match (tz.utc_offset, '(±)(%d%d:%d%d)'); -- ± only valid for offset 00:00		local s, t = mw.ustring.match (tz.utc_offset, '(±)(%d%d:%d%d)'); -- ± only valid for offset 00:00
	if s and '00:00' ~= t then		if s and '00:00' ~= t then
	return error_msg ('bad_sign');		return error_msg ({'Time', cfg.err_text['bad_sign']});
	end		end
	tz.df = 'iso';		tz.df = 'iso';
Line 399:		Line 399:
	tz = tz_aliases[args[1]] and tz_data[tz_aliases[args[1]]] or tz_data[args[1]]; -- make a local copy of the timezone table from tz_data{}		tz = tz_aliases[args[1]] and tz_data[tz_aliases[args[1]]] or tz_data[args[1]]; -- make a local copy of the timezone table from tz_data{}
	if not tz then		if not tz then
	return error_msg ('unknown_tz', args[1]); -- if the timezone given isn't in module:time/data(/sandbox)		return error_msg ({'Time', substitute (cfg.err_text['unknown_tz'], args[1])}); -- if the timezone given isn't in module:time/data(/sandbox)
	end		end
	end		end
Line 406:		Line 406:
	DF = DF:lower(); -- normalize to lower case		DF = DF:lower(); -- normalize to lower case
	if not cfg.df_vals[DF] then		if not cfg.df_vals[DF] then
	return error_msg ('bad_format', DF);		return error_msg ({'Time', substitute (cfg.err_text['bad_format'], DF)});
	end		end

Line 412:		Line 412:
	local test_time = get_test_time (args._TEST_TIME_);		local test_time = get_test_time (args._TEST_TIME_);
	if not test_time then		if not test_time then
	return error_msg ('test_time');		return error_msg ({'Time', cfg.err_text['test_time']});
	end		end

Line 432:		Line 432:

	if nil == dst_begin_ts or nil == dst_end_ts then		if nil == dst_begin_ts or nil == dst_end_ts then
	return error_msg ('bad_dst');		return error_msg ({'Time', cfg.err_text['bad_dst']});
	end		end

Line 451:		Line 451:
	end		end
	elseif is_set (tz.dst_begins) or is_set (tz.dst_ends) or is_set (tz.dst_time) then -- if some but not all not all parts then emit error message		elseif is_set (tz.dst_begins) or is_set (tz.dst_ends) or is_set (tz.dst_time) then -- if some but not all not all parts then emit error message
	return error_msg ('bad_def', ~~args~~[1]:upper());		return error_msg ({'Time', substitute (cfg.err_text['bad_def'], args_t[1]:upper())});
	else		else
	tz_abbr = tz.abbr; -- dst not observed for this timezone		tz_abbr = tz.abbr; -- dst not observed for this timezone
Line 501:		Line 501:

	if not is_set (tz.article) then -- if some but not all not all parts then emit error message		if not is_set (tz.article) then -- if some but not all not all parts then emit error message
	return error_msg ('bad_def', ~~args~~[1]:upper());		return error_msg ({'Time', substitute (cfg.err_text['bad_def'], args_t[1]:upper())});
	end		end

Line 544:		Line 544:

	if not args_t[1] then -- no timezone specifier		if not args_t[1] then -- no timezone specifier
	return error_msg ('missing_tz'); -- abandon with error message		return error_msg ({'UTC offset', cfg.err_text['missing_tz']}); -- abandon with error message
	end		end

Line 551:		Line 551:

	if not data.tz_data[timezone] then -- timezone specifier not known		if not data.tz_data[timezone] then -- timezone specifier not known
	return error_msg ('unknown_tz', timezone); -- abandon with error message		return error_msg ({'UTC offset', substitute (cfg.err_text['unknown_tz'], {timezone})}); -- abandon with error message
	end		end

Line 564:		Line 564:

	if nil == dst_begin_ts or nil == dst_end_ts then -- if either of these are nil		if nil == dst_begin_ts or nil == dst_end_ts then -- if either of these are nil
	return error_msg ('bad_dst'); -- abandon with error message		return error_msg ({'UTC offset', cfg.err_text['bad_dst']}); -- abandon with error message
	end		end

Line 582:		Line 582:

	elseif is_set (tz.dst_begins) or is_set (tz.dst_ends) or is_set (tz.dst_time) then -- if some but not all not all parts then emit error message		elseif is_set (tz.dst_begins) or is_set (tz.dst_ends) or is_set (tz.dst_time) then -- if some but not all not all parts then emit error message
	return error_msg ('bad_def', ~~args~~[1]:upper());		return error_msg ({'UTC offset', substitute (cfg.err_text['bad_def'], args_t[1]:upper())});

	else -- timezone does not use dst		else -- timezone does not use dst
	utc_offset = tz.utc_offset; -- return timezone-offset from utc		utc_offset = tz.utc_offset; -- return timezone-offset from utc
	end		end

Trappist the monk at 21:40, 1 May 2025

2025-05-01T21:40:53Z

← Previous revision		Revision as of 21:40, 1 May 2025
Line 557:		Line 557:
	local utc_timestamp = os.time (); -- get current server time (UTC) in seconds; used to determine when dst adjustment should be applied		local utc_timestamp = os.time (); -- get current server time (UTC) in seconds; used to determine when dst adjustment should be applied

	local ~~utc_offset~~ = get_utc_offset (); -- ~~utc~~ ~~offset~~ ~~for~~ ~~specified timezone~~ in seconds		local timestamp = utc_timestamp + get_utc_offset (); -- make local time timestamp (in seconds)
		⚫	local utc_offset;
	local timestamp = utc_timestamp + utc_offset; -- make local time timestamp (in seconds)
⚫	local ~~retval~~;

	if is_set (tz.dst_begins) and is_set (tz.dst_ends) and is_set (tz.dst_time) then -- make sure we have all of the parts		if is_set (tz.dst_begins) and is_set (tz.dst_ends) and is_set (tz.dst_time) then -- make sure we have all of the parts
Line 570:		Line 569:
	if invert then -- southern hemisphere; use beginning and ending of standard time in the comparison		if invert then -- southern hemisphere; use beginning and ending of standard time in the comparison
	if utc_timestamp >= dst_end_ts and utc_timestamp < dst_begin_ts then -- is current date time standard time?		if utc_timestamp >= dst_end_ts and utc_timestamp < dst_begin_ts then -- is current date time standard time?
	~~retval~~ = tz.utc_offset; -- return timezone-offset from utc		utc_offset = tz.utc_offset; -- return timezone-offset from utc
	else		else
	~~retval~~ = apply_dst_ajdust (tz.utc_offset); -- return dst-adjusted timezone-offset from utc		utc_offset = apply_dst_ajdust (tz.utc_offset); -- return dst-adjusted timezone-offset from utc
	end		end
	else -- northern hemisphere		else -- northern hemisphere
	if utc_timestamp >= dst_begin_ts and utc_timestamp < dst_end_ts then -- is current date time daylight time?		if utc_timestamp >= dst_begin_ts and utc_timestamp < dst_end_ts then -- is current date time daylight time?
	~~retval~~ = apply_dst_ajdust (tz.utc_offset); -- return dst-adjusted timezone-offset from utc		utc_offset = apply_dst_ajdust (tz.utc_offset); -- return dst-adjusted timezone-offset from utc
	else		else
	~~retval~~ = tz.utc_offset; -- return timezone-offset from utc		utc_offset = tz.utc_offset; -- return timezone-offset from utc
	end		end
	end		end
Line 586:		Line 585:

	else -- timezone does not use dst		else -- timezone does not use dst
	~~retval~~ = tz.utc_offset; -- return timezone-offset from utc		utc_offset = tz.utc_offset; -- return timezone-offset from utc
	end		end

	local sign, hours, minutes = ~~retval~~:match ('^([%-%+]?)(%d%d?):(%d%d)')		local sign, hours, minutes = utc_offset:match ('^([%-%+]?)(%d%d?):(%d%d)')
	if '' == sign then		if '' == sign then
	sign = '+';		sign = '+';

Trappist the monk at 19:42, 1 May 2025

2025-05-01T19:42:58Z

← Previous revision		Revision as of 19:42, 1 May 2025
Line 2:		Line 2:
	local yesno = require('Module:Yesno')		local yesno = require('Module:Yesno')
	local getArgs = require ('Module:Arguments').getArgs		local getArgs = require ('Module:Arguments').getArgs
		⚫	local data = mw.loadData ('Module:Time/data' .. (mw.getCurrentFrame():getTitle():match ('/sandbox') or '')); -- load the data module
		⚫	local cfg = data.cfg; -- for internationalization

	local tz = {}; -- holds local copy of the specified timezone table from tz_data{}		local tz = {}; -- holds local copy of the specified timezone table from tz_data{}
⚫	local cfg = {}; -- for internationalization


Line 353:		Line 354:
	local is_dst_tz;		local is_dst_tz;

	local data = table.concat ({'Module:Time/data', frame:getTitle():find('sandbox', 1, true) and '/sandbox' or ''}); -- make a data module name; sandbox or live
	data = mw.loadData (data); -- load the data module
	cfg = data.cfg; -- get the configuration table
	local tz_aliases = data.tz_aliases; -- get the aliases table		local tz_aliases = data.tz_aliases; -- get the aliases table
	local tz_data = data.tz_data; -- get the tz data table		local tz_data = data.tz_data; -- get the tz data table
Line 528:		Line 526:
	Mimics templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.		Mimics templates {{Time/GMT offset}}, {{Time/EST offset}}, etc.

	{{#invoke:Time/sandbox\|tz_offset\|<tz>}}		{{#invoke:Time/sandbox\|tz_offset\|<tz>}} – for a stand-alone invoke
			{{#invoke:Time/sandbox\|tz_offset}} – for an invoke in a template (<tz> is first positional parameter in the template call)

	where <tz> is a timezone abbreviation known to Module:Time/data		where <tz> is a timezone abbreviation known to Module:Time/data

			returns a UTC offset string suitable for use with the {{#time:}} parser function

	]]		]]
Line 539:		Line 540:
	return string.format ('%s:%s', tonumber (hours) + 1, minutes); -- return optional sign hh:mm string		return string.format ('%s:%s', tonumber (hours) + 1, minutes); -- return optional sign hh:mm string
	end		end

⚫	local data = mw.loadData ('Module:Time/data/sandbox'); -- load the data module
	cfg = data.cfg; -- get the configuration table

	local args_t = getArgs (frame); -- fetch arguments; only {{{1}}}, timesone specifier is used		local args_t = getArgs (frame); -- fetch arguments; only {{{1}}}, timesone specifier is used
Line 550:		Line 548:

	local timezone = args_t[1]:lower(); -- lowercase for indexing into tz data tables		local timezone = args_t[1]:lower(); -- lowercase for indexing into tz data tables
			timezone = data.tz_aliases[timezone] or timezone; -- if <timezone> is an alias, map to its canonical value

	if not data.tz_data[timezone] then -- timezone specifier not known		if not data.tz_data[timezone] then -- timezone specifier not known
Line 555:		Line 554:
	end		end

	-- tz = data.tz_data[timezone]; -- fetch a copy of this timezone's data; <tz> is a page-global table used by functions called from this function
	tz = data.tz_aliases[timezone] and data.tz_data[data.tz_aliases[timezone]] or data.tz_data[timezone]; -- fetch a copy of this timezone's data; <tz> is a page-global table used by functions called from this function		tz = data.tz_aliases[timezone] and data.tz_data[data.tz_aliases[timezone]] or data.tz_data[timezone]; -- fetch a copy of this timezone's data; <tz> is a page-global table used by functions called from this function
	local utc_timestamp = os.time (); -- get current server time (UTC) in seconds; used to determine when dst adjustment should be applied		local utc_timestamp = os.time (); -- get current server time (UTC) in seconds; used to determine when dst adjustment should be applied
Line 597:		Line 595:

	if 0 ~= tonumber (minutes) then		if 0 ~= tonumber (minutes) then
	return string.format ('%s%s %s %s%s minutes', sign, tonumber(hours), (1 == hours) and 'hour' or 'hours', sign, tonumber(minutes));		return string.format ('%s%s %s %s%s minutes', sign, tonumber(hours), ('1' == hours) and 'hour' or 'hours', sign, tonumber(minutes));
	else		else
	return string.format ('%s%s %s', sign, tonumber(hours), (1 == hours) and 'hour' or 'hours');		return string.format ('%s%s %s', sign, tonumber(hours), ('1' == hours) and 'hour' or 'hours');
	end		end
	return retval .. ' + hours'
	end		end

Trappist the monk at 16:54, 1 May 2025

2025-05-01T16:54:20Z

@@ Line 521: / Line 521: @@
 	return table.concat ({time_string, tz_tag, refresh_link});
 end
@@ Line 527: / Line 608: @@
 ]]
-return {time = time}
+return {

WOSlinker: use require('strict') instead of require('Module:No globals')

2022-10-21T09:58:25Z

use require('strict') instead of require('Module:No globals')

← Previous revision		Revision as of 09:58, 21 October 2022
Line 1:		Line 1:
	require ('~~Module:No globals~~')		require('strict')
	local yesno = require('Module:Yesno')		local yesno = require('Module:Yesno')
	local getArgs = require ('Module:Arguments').getArgs		local getArgs = require ('Module:Arguments').getArgs

Andrybak: use Module:Yesno to check boolean value of variable "DST": nil value defaulted to true, because Module:Yesno converts nil to nil; check for 'always' needs to go up

2020-05-24T23:41:05Z

use Module:Yesno to check boolean value of variable "DST": nil value defaulted to true, because Module:Yesno converts nil to nil; check for 'always' needs to go up

← Previous revision		Revision as of 23:41, 24 May 2020
Line 368:		Line 368:
	local Hide_tz = yesno(first_set (cfg.aliases['hide-tz'], args)); -- boolean		local Hide_tz = yesno(first_set (cfg.aliases['hide-tz'], args)); -- boolean
	local Unlink_tz = yesno(first_set (cfg.aliases['unlink-tz'], args)); -- boolean		local Unlink_tz = yesno(first_set (cfg.aliases['unlink-tz'], args)); -- boolean
	local DST = first_set (cfg.aliases['dst'], args);		local DST = first_set (cfg.aliases['dst'], args) or true; -- string 'always' or boolean

	local Lang = first_set (cfg.aliases['lang'], args); -- to render in a language other than the local wiki's language		local Lang = first_set (cfg.aliases['lang'], args); -- to render in a language other than the local wiki's language
Line 424:		Line 424:
	timestamp = utc_timestamp + utc_offset; -- make local time timestamp		timestamp = utc_timestamp + utc_offset; -- make local time timestamp

	if 'no' == DST then -- ~~for~~ ~~timezones~~ ~~that~~ DO ~~observe~~ dst ~~but for this location ...~~		if 'always' == DST then -- if needed to always display dst time
⚫	tz_abbr = tz.abbr; -- ... dst is not observed (\|dst=no) show time as standard time
	elseif 'always' == DST then -- if needed to always display dst time
	timestamp = timestamp + 3600; -- add a hour for dst		timestamp = timestamp + 3600; -- add a hour for dst
	tz_abbr = tz.dst_abbr; -- dst abbreviation		tz_abbr = tz.dst_abbr; -- dst abbreviation
			elseif not yesno(DST) then -- for timezones that DO observe dst but for this location ...
		⚫	tz_abbr = tz.abbr; -- ... dst is not observed (\|dst=no) show time as standard time
	else		else
	if is_set (tz.dst_begins) and is_set (tz.dst_ends) and is_set (tz.dst_time) then -- make sure we have all of the parts		if is_set (tz.dst_begins) and is_set (tz.dst_ends) and is_set (tz.dst_time) then -- make sure we have all of the parts