JavaScript аналог String.Format C#

Что тут есть?

Те, кто пишут на C# очень хорошо знают и часто используют механизм String.Format, которого им сильно не хватает в JavaScript. Для облегчения жизни и был сделан этот небольшой скрипт - реализация String.Format для JavaScript. Естественно реализация один-к-одному крайне затруднительна и есть некоторые несовместимости, однако реализованный функционал позволяет делать достаточно удобные вещи.
Основные возможности:

• Маркеры как в C#: {0}
• Можно задавать используемую функцию форматирования: {0:d}
• Можно передавать параметры функции форматирования: {0:n(,2)}
• Можно регистрировать свои фунции форматирования
• Два варианта вызова:
  1. Как в C#:

     var s = String.Format(format, arg0[, arg1[, arg2[...]]]);

  2. Как метод у объекта String:

     var s = 'format string {0}'.format(arg0[, arg1[, arg2[...]]]);

• Уже реализованы и встроены функции форматирования:
  • Форматирование массовов
  • Форматирование чисел
  • Форматирование даты и времени

Попробовать прямо сейчас

(function(format)
{
    // Регистрация функции форматирования, подробности ниже.
    format.add('my', function(v, params)
    {
return '{'.concat(v, ':my(', params.join(','), ')}');
    });
})(String.prototype.format);

$('#trybtn').click(function(){
    $('#tryresult').text(
        String.Format(
            '',
             
        )
    );
});

/* После нажатия на кнопку Try результат будет тут:
 */
Try!

QUnit тесты

Выполнить тестыПоказать код тестов

Как использовать, регистрировать свои функции форматирования и получать существующие

Как было сказано ранее, есть 2 варианта использования:

1. Как в C#:

   var s = String.Format(format, arg0[, arg1[, arg2[...]]]);

2. Как метод у объекта String:

   var s = 'format string {0}'.format(arg0[, arg1[, arg2[...]]]);

Описание встроенных форматов

(function(nf)
{
	nf.add('my', function(v, params)
	{
		// v гарантированно будет числом
		// В params[0] будет строка 'my'
		return v==1?params[1]:params[2];
	}
})(String.prototype.format.get('nf'));

Получение зарегистрированных функций форматирования

(function(format)
{
	var f						= format.get('df');		// Получаем функцию форматирования даты/времени
	alert(f(new Date(), ['yyyy-MM-dd HH/mm/ss/ffff']));	// Используем по своему усмотрению
})(String.prototype.format);

Настройка функций форматирования

11.06.2010 10:16:40 мне написали:

Локаль: String.Format не распознает русский децимальный разделитель ",". Если писать веб-формы для автоматизации, то это было-бы полезно. Конечно, можно конвертировать перед этим, но... :)

Спасибо огромние за идею, я добавил возможность поменять настройки форматирования, делается это следующим образом:

(function(format)
{
	format.init({
		n: {									// Настройки для форматирования чисел:
			dseparator: '.',					// - разделитель целой и дробной части
			nan:		'NaN'					// - текст, выводимый при попытке отформатировать не число
		},
		df: {									// Настройки для форматирования даты+времени:
			nad:		'NaD',					// - текст, выводимый при попытке отформатировать не объект даты
			d:			'dd.MM.yyyy',			// - формат для :d
			dts:		'dd.MM.yyyy HH:mm:ss',	// - формат для :dts
			dt:			'dd.MM.yyyy HH:mm',		// - формат для :dt
			ts:			'HH:mm:ss',				// - формат для :ts
			t:			'HH:mm'					// - формат для :t
		},
		ts: {									// Настройки для форматирования времени счетчика:
			d:			'дн.',					// - обозначение дней
			h:			'час.',					// - обозначение часов
			m:			'мин.',					// - обозначение минут
			s:			'сек.',					// - обозначение секунд
			ms:			'мс'					// - обозначение миллисекунд
		}
	});
	
	format.init({ n: { }, df: { }, ts: { } });	// Сброс настроек
})(String.prototype.format);

Настройки можно указывать не полностью, тогда для пропущенных параметров будут использоваться значения по-умолчанию. Настройки для разных функций форматирования можно указывать независимо:

(function(format)
{
	format.init({
		n: {
			dseparator: ','		// Разделитель целой и дробной части теперь будет запятой, а настройка nan будет по-умолчанию = 'NaN'
		}
	});
	
	format.init({				// Этот вызов никаким образом не затронет настройку для формата n
		df: {
			nad:		'!Date'	// Изменен параметр nad, а все остальные будут = значениям по-умолчанию
		}
	});
	
	format.init({ n: { } });	// Сброс настроек повлияет только на формат n
})(String.prototype.format);

Регистрация своей функции форматирования

(function(format)
{
	// Регистрация функции форматирования, использовать можно так: '{0:my(p1,p2,p3)}'.format(v)
	// v - значение для ворматирования, в функцию будет передано так же, как его передали в функцию format
	// params - массив параметров, всегда есть, но межет быть нулевого размера
	// Функция обязана вернуть строку, которая будет подставлена вместо метки
	format.add('my', function(v, params)
	{
		return '{'.concat(v, ':my(', params.join(','), ')}');
	});
})(String.prototype.format);

Версии