/* https://github.com/alexei/sprintf.js/blob/master/src/sprintf.js */
/* global window, exports, define */
numeric_arg: /[bcdiefguxX]/,
placeholder: /^\x25(?:([1-9]\d*)\$|\(([^)]+)\))?(\+)?(0|'[^$])?(-)?(\d+)?(?:\.(\d+))?([b-gijostTuvxXD])/,
key: /^([a-z_][a-z_\d]*)/i,
key_access: /^\.([a-z_][a-z_\d]*)/i,
index_access: /^\[(\d+)\]/,
// arguments is not an array, but should be fine for this call
return sprintf_format(sprintf_parse(key), arguments)
function vsprintf(fmt, argv) {
return sprintf.apply(null, [fmt].concat(argv || []))
function sprintf_format(parse_tree, argv) {
var cursor = 1, tree_length = parse_tree.length, arg, output = '', i, k, ph, pad, pad_character, pad_length, is_positive, sign
for (i = 0; i < tree_length; i++) {
if (typeof parse_tree[i] === 'string') {
else if (typeof parse_tree[i] === 'object') {
ph = parse_tree[i] // convenience purposes only
if (ph.keys) { // keyword argument
for (k = 0; k < ph.keys.length; k++) {
throw new Error(sprintf('[sprintf] Cannot access property "%s" of undefined value "%s"', ph.keys[k], ph.keys[k-1]))
else if (ph.param_no) { // positional argument (explicit)
else { // positional argument (implicit)
if (re.not_type.test(ph.type) && re.not_primitive.test(ph.type) && arg instanceof Function) {
if (re.numeric_arg.test(ph.type)){
let argtype = typeof arg;
if ( argtype !== 'bigint') {
if ( argtype !== 'number' && isNaN(arg) ) {
throw new TypeError(sprintf('[sprintf] expecting number but found %T', arg))
if (re.number.test(ph.type)) {
arg = parseInt(arg, 10).toString(2)
arg = String.fromCharCode(parseInt(arg, 10))
select date format with width
select time format with precision
%1.1D => 07/07/20, 13:31 AM
%1.2D => 07/07/20, 13:31:55 AM
%2.2D => May 5, 2022, 9:29:16 AM
%3.3D => May 5, 2022 at 9:28:16 AM GMT+2
%4.4D => Thursday, May 5, 2022 at 9:26:59 AM Central European Summer Time
see meaning of DateTimeFormat's options "datestyle" and "timestyle" in MDN
let [datestyle, timestyle] = [ph.width, ph.precision].map(val => ({
if(timestyle === undefined && datestyle === undefined){
/* get lang from globals */
let lang = get_current_lang_code();
f = new Intl.DateTimeFormat(lang, options);
f = new Intl.DateTimeFormat('en-US', options);
TODO: select with padding char
a: absolute time and date (default)
arg = JSON.stringify(arg, null, ph.width ? parseInt(ph.width) : 0)
arg = ph.precision ? parseFloat(arg).toExponential(ph.precision) : parseFloat(arg).toExponential()
arg = ph.precision ? parseFloat(arg).toFixed(ph.precision) : parseFloat(arg)
arg = ph.precision ? String(Number(arg.toPrecision(ph.precision))) : parseFloat(arg)
arg = (parseInt(arg, 10) >>> 0).toString(8)
arg = (ph.precision ? arg.substring(0, ph.precision) : arg)
arg = (ph.precision ? arg.substring(0, ph.precision) : arg)
arg = Object.prototype.toString.call(arg).slice(8, -1).toLowerCase()
arg = (ph.precision ? arg.substring(0, ph.precision) : arg)
arg = parseInt(arg, 10) >>> 0
arg = (ph.precision ? arg.substring(0, ph.precision) : arg)
arg = (parseInt(arg, 10) >>> 0).toString(16)
arg = (parseInt(arg, 10) >>> 0).toString(16).toUpperCase()
if (re.json.test(ph.type)) {
if (re.number.test(ph.type) && (!is_positive || ph.sign)) {
sign = is_positive ? '+' : '-'
arg = arg.toString().replace(re.sign, '')
pad_character = ph.pad_char ? ph.pad_char === '0' ? '0' : ph.pad_char.charAt(1) : ' '
pad_length = ph.width - (sign + arg).length
pad = ph.width ? (pad_length > 0 ? pad_character.repeat(pad_length) : '') : ''
output += ph.align ? sign + arg + pad : (pad_character === '0' ? sign + pad + arg : pad + sign + arg)
var sprintf_cache = Object.create(null)
function sprintf_parse(fmt) {
if (sprintf_cache[fmt]) {
return sprintf_cache[fmt]
var _fmt = fmt, match, parse_tree = [], arg_names = 0
if ((match = re.text.exec(_fmt)) !== null) {
parse_tree.push(match[0])
else if ((match = re.modulo.exec(_fmt)) !== null) {
else if ((match = re.placeholder.exec(_fmt)) !== null) {
var field_list = [], replacement_field = match[2], field_match = []
if ((field_match = re.key.exec(replacement_field)) !== null) {
field_list.push(field_match[1])
while ((replacement_field = replacement_field.substring(field_match[0].length)) !== '') {
if ((field_match = re.key_access.exec(replacement_field)) !== null) {
field_list.push(field_match[1])
else if ((field_match = re.index_access.exec(replacement_field)) !== null) {
field_list.push(field_match[1])
throw new SyntaxError('[sprintf] failed to parse named argument key')
throw new SyntaxError('[sprintf] failed to parse named argument key')
throw new Error('[sprintf] mixing positional and named placeholders is not (yet) supported')
throw new SyntaxError('[sprintf] unexpected placeholder')
_fmt = _fmt.substring(match[0].length)
return sprintf_cache[fmt] = parse_tree
* export to either browser or node.js
/* eslint-disable quote-props */
if (typeof exports !== 'undefined') {
exports['sprintf'] = sprintf
exports['vsprintf'] = vsprintf
if (typeof window !== 'undefined') {
window['sprintf'] = sprintf
window['vsprintf'] = vsprintf
if (typeof define === 'function' && define['amd']) {
/* eslint-enable quote-props */
}(); // eslint-disable-line