Module:YouTube

 Documentation

Ce module Lua est utilisé par le modèle {{YouTube}}.

Page à prévisualiser pour vérifier les modifications : Discussion module:YouTube/Test.

La documentation de ce module est incluse depuis sa sous-page de documentation (modifier | historique).
Veuillez placer les catégories dans la sous-page /Documentation.
Les éditeurs peuvent travailler dans le bac à sable (créer).

--[[
* format canonique : 1230s (tout en secondes)

* YouTube supporte davantage de formats, mais redirige vers le format canonique :
** il peut y avoir des leading zeroes
** heures, minutes, secondes peuvent être spécifiés dans n'importe quel ordre
** si on spécifie uniquement des secondes, le suffixe "s" peut être omis
]]

local p = {}

local function toSeconds( number, unit )
    if unit == 's' then
        return tonumber( number )
    elseif unit == 'm' then
        return number * 60
    elseif unit == 'h' then
        return number * 3600
    end
end

local function timestampToNbSeconds( timestamp )
    local num1, unit1, num2, unit2, num3, unit3

    -- "30s" (format canonique de YouTube)
    num1, unit1 = timestamp:match( '^0*(%d+)([hms])$' )
    if num1 then
        return toSeconds( num1, unit1 )
    end

    -- "20m30s" (format aussi reconnu par YouTube)
    num1, unit1, num2, unit2 = timestamp:match( '^0*(%d+)([hms])0*(%d+)([hms])$' )
    if num1 then
        return toSeconds( num1, unit1 ) + toSeconds( num2, unit2 )
    end

    -- "1h20m30s" (format aussi reconnu par YouTube)
    num1, unit1, num2, unit2, num3, unit3 = timestamp:match( '^0*(%d+)([hms])0*(%d+)([hms])0*(%d+)([hms])$' )
    if num1 then
        return toSeconds( num1, unit1 ) + toSeconds( num2, unit2 ) + toSeconds( num3, unit3 )
    end

    local hours, minutes, seconds

    -- "30" (format aussi reconnu par YouTube)
    seconds = timestamp:match( '^0*(%d+)$' )
    if seconds then
        return tonumber( seconds )
    end

    -- "20:30" (format *non* reconnu par YouTube)
    minutes, seconds = timestamp:match( '^0*(%d+):0*(%d+)$' )
    if minutes then
        return minutes * 60 + seconds
    end

    -- "1:20:30" (format *non* reconnu par YouTube)
    hours, minutes, seconds = timestamp:match( '^0*(%d+):0*(%d+):0*(%d+)$' )
    if hours then
        return hours * 3600 + minutes * 60 + seconds
    end

    return false
end

local function abbr( text, title )
    return '<abbr class="abbr" title="' .. title .. '">' .. text .. '</abbr>'
end

function p.timestamp( frame )
    local timestamp = frame.args[ 1 ]

    local nbSeconds = timestampToNbSeconds( timestamp )
    if not nbSeconds then
        -- fallback: return the original input
        return timestamp
    end

    return nbSeconds .. 's'
end

function p.libelle( frame )
    local timestamp = frame.args[ 1 ]

    local nbSeconds = timestampToNbSeconds( timestamp )
    if not nbSeconds then
        -- fallback: return the original input
        return timestamp
    end

    if nbSeconds == 0 then
        -- special case: if timestamp at 0:00, return « 0 s » rather than empty string
        return '0' .. '\194\160' .. abbr( 's', 'seconde' )
    end

    local parts = {}

    local hours = math.floor( nbSeconds / 3600 )
    if hours > 0 then
        parts[ #parts + 1 ] = hours .. '\194\160' .. abbr( 'h', 'heure' .. ( hours > 1 and 's' or '' ) )
        nbSeconds = nbSeconds - hours * 3600
    end

    local minutes = math.floor( nbSeconds / 60 )
    if minutes > 0 then
        parts[ #parts + 1 ] = minutes .. '\194\160' .. abbr( 'min', 'minute' .. ( minutes > 1 and 's' or '' ) )
        nbSeconds = nbSeconds - minutes * 60
    end

    if nbSeconds > 0 then
        parts[ #parts + 1 ] = nbSeconds .. '\194\160' .. abbr( 's', 'seconde' .. ( nbSeconds > 1 and 's' or '' ) )
    end

    return table.concat( parts, '\194\160' )
end

return p