функция %DATE()%
Выводит отформатированную строку даты. Первый аргумент — строка форматирования, второй (необязательный) — количество секунд от начала отсчета.
Строка форматирования принимает следующие параметры:
- %a — "am" или "pm"
- %A — "AM" или "PM"
- %d — число месяца с незначащим нулем, т.е. "01"-"31"
- %D — день недели, трехсимвольное сокращение от английкого названия, например, "Fri"
- %F — полное название месяца по-английски, например, "January"
- %g — часы в 12-и часовом формате без незначащего нуля, т.е. "1"-"12"
- %G — часы в 24-х часовом формате без незначащего нуля, т.е. "0"-"23"
- %h — часы в 12-и часовом формате с незначащим нулем, т.е. "01"-"12"
- %H — часы в 24-х часовом формате с незначащим нулем, т.е. "00"-"23"
- %i — минуты, "00"-"59"
- %j — число месяца без незначащего нуля, т.е. "1"-"31"
- %l — (латинская маленькая L) полное название дня недели по-английски, например, "Friday"
- %m — месяц, "01" — "12"
- %M — месяц, трехсимвольное сокращение от английкого названия, например, "Jan"
- %n — месяц, без незначащего нуля, т.е. "1"-"12"
- %s — секунды, "00"-"59"
- %y — год, две цифры, например "99"
- %Y — год, четыре цифры, например, "1999"
- %д — (русская буква д) день недели, двусимвольное сокращение от русского названия, например, "Пт"
- %Д — (русская буква Д) полное название дня недели по-русски, например, "пятница"
- %М — (русская буква М) полное название месяца по-русски в родительном падеже, например, "января"
Пример
%DATE("%d.%m.%y %H:%i:%s", %CHAT('FIRST')%)%
функция %TIME()%
Выводит количество секунд, прошедших от начала отсчета до текущего момента с учетом корректировки времени
для чата. Необязательным аргументом является число, которое прибавляется к текущему времени.
Пример
Выводит количество секунд, прошедших сутки назад:
%TIME(-86400)%
функция %LONG_DAYS()%
Преобразует количество секунд, переданные в аргументе, в количество дней/часов/минут.
Пример
%LONG_DAYS(100000)%
Этот код выведет на экран сообщение "1 день 3 часа 46 минут".
Функция позволяет переопределять строковые значения, что может быть полезно, например, для вывода сообщения на
другом языке или в более короткой записи. Для переопределения строковых значений имеются два варианта передачи
строк: сокращенный вариант, когда строковые значения не зависят от выводимых чисел и полный вариант, когда строковые
значения зависят от выводимых чисел (1 день, 2 дня, 5 дней).
Пример
Сокращенный вариант вывода строковых значений:
%LONG_DAYS(100000, ["д.", "ч.", "м."])%
Этот код выведет на экран сообщение "1 д. 3 ч. 46 м.".
Пример
%LONG_DAYS(100000, ["day(s)", "hour(s)", "minute(s)"])%
Этот код выведет на экран сообщение "1 day(s) 3 hour(s) 46 minute(s)".
Пример
Полный вариант вывода строковых значений:
%LONG_DAYS(100000, ["ДЕНЬ", "ЧАС", "МИНУТА"], ["ДНЯ", "ЧАСА", "МИНУТЫ"], ["ДНЕЙ", "ЧАСОВ", "МИНУТ"])%
Этот код выведет на экран сообщение "1 ДЕНЬ 3 ЧАСА 46 МИНУТ".
функция %LONG_TIME()%
Преобразует количество секунд, переданные в аргументе, в количество часов/минут/секунд. Необязательный второй
аргумент управляет выводом секунд в сообщении и может принимать два значения: 0 — секунды выводятся,
1 — секунды отбрасываются (значение по умолчанию),
.
Пример
%LONG_TIME(100000)%
или
%LONG_TIME(100000, 1)%
Этот код выведет на экран сообщение "27 часов 46 минут".
Пример
%LONG_TIME(100000, 0)%
Этот код выведет на экран сообщение "27 часов 46 минут 40 секунд".
Функция позволяет переопределять строковые значения, что может быть полезно, например, для вывода сообщения на
другом языке или в более короткой записи. Для переопределения строковых значений имеются два варианта передачи
строк: сокращенный вариант, когда строковые значения не зависят от выводимых чисел и полный вариант, когда строковые
значения зависят от выводимых чисел (1 час, 2 часа, 5 часов).
Пример
Сокращенный вариант вывода строковых значений:
%LONG_TIME(100000, 0, ["h", "m", "s"])%
Этот код выведет на экран сообщение "27 h 46 m 40 s".
Пример
%LONG_TIME(100000, 0, ["hour(s)", "minute(s)", "second(s)"])%
Этот код выведет на экран сообщение "27 hour(s) 46 minute(s) 40 second(s)".
Пример
Полный вариант вывода строковых значений:
%LONG_TIME(100000, 0, ["ЧАС", "МИНУТА", "СЕКУНДА"], ["ЧАСА", "МИНУТЫ", "СЕКУНДЫ"], ["ЧАСОВ", "МИНУТ", "СЕКУНД"])%
Этот код выведет на экран сообщение "27 ЧАСОВ 46 МИНУТ 40 СЕКУНД".
функции %CFG()% и %CFGJS()%
Эти функции предназначены для получения значений из конфигурации чата, в функцию должен передаваться один
аргумент — имя конфигурационной переменной.
Пример
%CFG('Charset')%
Выводит кодировку из настроек чата.
функция %SESS()%
Функция предназначена для создания и получения сессионных переменных. Эта функция пригодится только тем, кто хорошо понимает принцип работы http-протокола и знаком с сессиями.
- %SESS()% — возвращает номер текущей сессии
- %SESS("NAME", VALUE)% — создает сессионную переменную NAME и записывает в нее значение VALUE
- %SESS("NAME")% — возвращает значение сессионной переменной NAME
функция %TRIM()%
Аргументом этой функции является строка, возвращает входную строку с удаленными концевыми пробельными символами.
Пример
%STR = ' пример с функцией %TRIM()% '%
`%TRIM(%STR%)%`
Результатом работы этого примера будет строка "пример с функцией `%TRIM()%`".
функция %UP_CASE()%
Аргументом этой функции является строка, преобразует строку в верхний регистр.
Пример
%STR = 'пример с функцией %UP_CASE()%'%
%UP_CASE(%STR%)%
Результатом работы этого примера будет строка "ПРИМЕР С ФУНКЦИЕЙ %UP_CASE()%".
функция %LOW_CASE()%
Аргументом этой функции является строка, преобразует строку в нижний регистр.
Пример
%STR = 'ПРИМЕР С ФУНКЦИЕЙ %LOW_CASE()%'%
%LOW_CASE(%STR%)%
Результатом работы этого примера будет строка "пример с функцией %low_case()%".
функция %CSS()%
Подключает таблицу стилей к странице. Для нас будет интересен только аргумент 5, т.к. все
остальные номера уже используются в чате для подключения стилей в окнах и фреймах.
Стили под номером 5 определяются разеделе "Дизайн" в пользовательских стилях и их можно
использовать на дополнительных страничках.
Примерный вид заготовки дополнительных страничек может быть такой:
<html>
<head>
<title>наш заголовок</title>
%CSS(5)%
</head>
<body>
...
здесь ваш код
...
</body>
</html>
В пользовательских стилях необходимо самим назначать имена селекторов и уже эти имена использовать в названиях классов на создаваемой странице.
Кроме того, стили под номером 5 подключаются в окнах "Помощь", "Правила чата", "Для нарушителей" и во фрейме "Информация".
