debuffDuration

Returns the time remaining on a debuff or 0.

debuffDuration(spell, [unit]) : integer
-- alts
debuffduration(spell, [unit]) : integer
debuffDuration(spell, [unit]) : integer
-- alts
debuffduration(spell, [unit]) : integer

1. SpellID from the class spellbooks
2. See Wowpedia for more information on WoW Unit IDs.
3. Use of object is also supported for unit / unit.

Example

Return the time left on Starfire debuff

if debuffDuration(Starfire, 'target') < 3 then
    return cast(Starfire, 'target')
end
if debuffDuration(Starfire, 'target') < 3 then
    return cast(Starfire, 'target')
end

Note

Spell ID's and Buff ID's for the same spell are not the same. If you find yourself spam caasting something, that is probably the reason.