モジュール:TwitterSnowflake
Luaモジュールを使用しています: |
このモジュールはTwitterやDiscordで使用されているテンプレート:仮リンクをタイムスタンプに変換します。{{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=
を指定してください。
関連項目
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