モジュール:TwitterSnowflake

モジュールの解説[表示] [編集] [履歴] [キャッシュを破棄]

このモジュールはTwitterやDiscordで使用されているSnowflake IDをタイムスタンプに変換します。{{Cite tweet}}などで出典日付を自動生成するために使用されます。

使い方

書式：{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=Snowflake ID}}

|id_str=は入力必須で、投稿のSnowflake ID（例: 1345021162959503360）を入力します。

たとえば、{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=1345021162959503360}}はJanuary 1, 2021を返します。

日付の書式は|format=で指定できます。たとえば、{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=1345021162959503360|format=%e %B %Y}}は 1 January 2021を返します。これは主に出典表記形式1で使用されます。

|epoch=はエポック（Snowflake IDの起点時刻）を指定できます。既定ではTwitterでの起点時刻（|1288834974=）が使用されます。Discordの場合は|1420070400=を指定してください。

関連項目

• {{Cite tweet}}
• Snowflake ID

この解説は、モジュール:TwitterSnowflake/docから呼び出されています。 (編集 | 履歴)
編集者は、このモジュールをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
このモジュールのサブページ一覧。

local p = {}

local Date = require('Module:Date2')._Date

function p.snowflakeToDate(frame)
	local format = frame.args.format or "%B %e, %Y"
	local epoch = tonumber(frame.args.epoch) or 1288834974
	local id_str = frame.args.id_str
	if type(id_str) ~= "string" then error("第1引数が不正です（入力タイプは" .. type(id_str) .. "ですが、stringタイプが必要です）", 2) end
	if type(format) ~= "string" then error("第2引数が不正です（入力タイプは" .. type(format) .. "ですが、stringタイプが必要です）", 2) end
	if type(epoch) ~= "number" then error("第3引数が不正です（入力タイプは" .. type(epoch) .. "ですが、numberタイプが必要です）", 2) end
	local hi, lo = 0, 0
	local hiexp = 1
	local two32 = 2^32
	for c in id_str:gmatch(".") do
		lo = lo * 10 + c
		if lo >= two32 then
			hi, lo = hi * 10^hiexp + math.floor(lo / two32), lo % two32
			hiexp = 1
		else hiexp = hiexp + 1 end
	end
	hi = hi * 10^(hiexp-1)
	local timestamp = math.floor((hi * 1024 + math.floor(lo / 4194304)) / 1000) + epoch
	return os.date(format, timestamp)
end

function p.getDate(frame)
	-- just pass frame directly to snowflakeToDate, this wraps it but the args are the same plus
	if (frame.args.id_str):match("%D") then -- not a number, so return -2
		return -2
	end
	frame.args.format = "%B %e, %Y"
	if frame.args.date and not string.find(frame.args.date, "年") then			--日本語日付の場合は置換しない
		frame.args.date = mw.ustring.gsub(frame.args.date, "(%d%d%d%d)%a", "%1")
	end
	frame.args.epoch = tonumber(frame.args.epoch) or 1288834974
	local epochdate = Date(os.date("%B %e, %Y", frame.args.epoch))
	local twitterdate = Date(p.snowflakeToDate(frame))
	if twitterdate == epochdate then -- created before epoch, so can't determine the date
		return -1
	end
	local date = Date(frame.args.date) or 0 -- if we error here, then an input of no date causes an error, which is contrary to the entire way {{TwitterSnowflake/datecheck}} works
	return date - twitterdate
end

local function abs_datediff(x)
	if type(x) == 'number' then return math.abs(x) end
	return math.abs(x.age_days)
end

function p.datecheck(frame)
	local args = frame.args
	if not (args.date and args.id_str) then
		error('dateとid_strは空白でも入力する必要があります。')
	end
	local errors = {
		args.error1 or 'dateの値とSnowflake IDから計算された日付が2日以上異なります',
		args.error2 or 'dateが未入力、かつ2010年11月4日以前の投稿です',
		args.error3 or 'id_strが不正です'
	}
	if mw.title.getCurrentTitle():inNamespace(0) and args.error_cat then
		for i = 1, 3 do errors[i] = errors[i] .. '[[' .. args.error_cat .. ']]' end
	end
	if not args.date:match('^%s*$') then -- #if:{{{date|}}}
		local testResult = p.getDate{ args = { date = args.date, id_str = args.id_str }}
		if testResult == -2 then return errors[3] end
		if abs_datediff(testResult) > 1 then return errors[1] end
	elseif not args.id_str:match('^%s*$') then
		local testResult = p.getDate{ args = { id_str = args.id_str }}
		if testResult == -1 then return errors[2] end
		if testResult == -2 then return errors[3] end
	end
end

return p