Módulo:TwitterSnowflake
Este módulo está classificado como pré-alfa. Ele está incompleto, e pode ou não estar em desenvolvimento activo. Ele deve ser utilizado desde páginas do domínio artigos. Os módulos ficam em pre-alfa até o editor original (ou alguém que toma conta se ele for abandonado por algum tempo) está satisfeito com a estrutura básica. |
Este é um módulo para traduzir Snowflake ID (en) desde plataformas como Twitter e Discord para datas (timestamps). Isto pode ser utilizado para automaticamente gerar datas para predefinições como {{citar tweet}}
.
Uso
[editar código-fonte]Existe um parâmetro obrigatório: |id_str=
, o qual deve ser o ID snowflake ID do tweet. Por exemplo, 1345021162959503360
.
{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=1345021162959503360}}
mostra 2021-01-01.
Para definir o formato da data, utilize |format=
.
{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=1345021162959503360|format=%e %B %Y}}
returns 2021-01-01 — prática para se usar, especialmente para citações CS1 (Citation), em caso de formato padrão de data poder alterar no futuro (apesar de pouco provável).
Época por medida
[editar código-fonte]Por padrão a época é utilizada é a do Twitter. Para definir outra época diferente, como a do Twitter, use |epoch=
. A época de Discord é 1420070400
{{#invoke:TwitterSnowflake|snowflakeToDate|id_str=797545051047460888|epoch=1420070400}}
mostra 2021-01-09.
Ver também
[editar código-fonte]- Predefinição:TwitterSnowflake
- Predefinição:Citar tweet
- Snowflake ID (en)
local p = {}
local Date = require('Módulo:Data')._Date
function p.snowflakeToDate(frame)
local format = "%Y-%m-%d"
local epoch = tonumber(frame.args.epoch) or 1288834974
local id_str = frame.args.id_str
if type(id_str) ~= "string" then error("argumento #1 incorreto (esperado string, obtido " .. type(id_str) .. ")", 2) end
if type(format) ~= "string" then error("argumento #2 incorreto (esperado string, obtido " .. type(format) .. ")", 2) end
if type(epoch) ~= "number" then error("argumento #3 incorreto (esperado number, obtido " .. type(epoch) .. ")", 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 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('Must define date and id_str, even if they are blank.')
end
local errors = {
args.error1 or 'Date mismatch of two or more days',
args.error2 or 'No date, and posted before November 4, 2010',
args.error3 or 'Invalid 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