Module:Рандом/доc

Тҳис модуле cонтаинс а нумбер оф фунcтионс тҳат усе рандом нумберс. Ит cан оутпут рандом нумберс, селеcт а рандом итем фром а лист, анд реордер лисц рандомлй. Тҳе рандомлй реордеред лисц cан бе оутпут инлине, ор ас вариоус тйпес оф ордеред анд унордеред лисц. Тҳе аваилабле фунcтионс аре оутлинед ин море детаил белоw.

Нумбер

Тҳе number фунcтион оутпуц а рандом нумбер.

{{#invoke:random|number|m|n|same=yes}}

Тҳе аргуменц m анд n май бе омиттед, бут иф спеcифиэд муст бе cонвертибле то интегерс.

• Wитҳ но аргуменц, ретурнс а реал нумбер ин тҳе ранге $[0,1)$.
• Wитҳ оне аргумент, ретурнс ан интегер ин тҳе ранге $[1,m]$, ор, иф m ис негативе, $(-m,0]$. Иф m ис эқуал то 0 ор 1, ретурнс 1 (ор 0 иф $m=-1$).
• Wитҳ тwо аргуменц, ретурнс ан интегер ин тҳе ранге $[m,n]$. m анд n cан бе эитҳер поситиве ор негативе. Иф m ис греатер тҳан n, ретурнс ан интегер ин тҳе ранге $[n,m]$ инстеад.
• Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме рандом нумбер ис ретурнед фор эач модуле cалл он а гивен паге.

Эхамплес ()

• {{#invoke:random|number}} → 0.83985606946044
• {{#invoke:random|number|100}} → 26
• {{#invoke:random|number|-100|-50}} → -54
• {{#invoke:random|number|100|same=yes}} → 14
• {{#invoke:random|number|100|same=yes}} → 14

Тҳе доcументатион фор тҳис фунcтион ис партлй такен фром тҳе Сcрибунто Луа референcе мануал, wҳич ис ин турн басед он тҳе Луа 5.1 Референcе Мануал, аваилабле ундер тҳе МИТ Лиcенсе.

Дате

Тҳе date фунcтион оутпуц а рандом дате.

{{#invoke:random|date|timestamp1|timestamp2|format=date format|same=yes}}

• Иф но тиместамп аргуменц аре спеcифиэд, тҳе модуле оутпуц а рандом дате ин тҳе cуррент еар.
• Иф timestamp1 анд timestamp2 аре спеcифиэд, тҳе модуле оутпуц а рандом дате бетwеэн тҳе тwо тиместампс. timestamp1 муст бе эарлиэр тҳан timestamp2.
• Иф онлй timestamp1ис спеcифиэд, тҳе модуле оутпуц а рандом дате бетwеэн тҳе Уних эпоч (1 Жан 1970) анд тҳе тиместамп. timestamp1 муст нот бе эарлиэр тҳан 1 Жан 1970.
• Форматтинг cан бе спеcифиэд wитҳ тҳе |формат= параметер. Тҳе дефаулт форматтинг ис "ҳҳ:мм, ДД Монтҳ ЙЙЙЙ (УТC)" (тҳе саме ас тҳе дефаулт Wикипедиа тиместамп).
• Тҳе тиместампс анд тҳе |формат= параметер аccепт валуэс cомпатибле wитҳ тҳе #тиме парсер фунcтион. Плеасе сеэ тҳе #тиме доcументатион фор тҳе фулл ранге оф поссибле инпут валуэс анд форматтинг оптионс.
• Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме дате ис ретурнед фор эач модуле cалл он а гивен паге.

Эхамплес ()

• {{#invoke:random|date}} → 04:35, 18 сентябр 2025 (УТC)
• {{#invoke:random|date|format=F j}} → ноябр 3
• {{#invoke:random|date|1 Jan 1980|31 Dec 1999}} → 00:46, 24 октябр 1990 (УТC)
• {{#invoke:random|date|1st January 1500|1st January 3000|format=g:i a, l d M Y}} → 11:07 ам, Душанба 22 апр 2701
• {{#invoke:random|date|1970/06/01}} → 01:08, 23 январ 1970 (УТC)
• {{#invoke:random|date|same=yes}} → 00:37, 21 феврал 2025 (УТC)
• {{#invoke:random|date|same=yes}} → 00:37, 21 феврал 2025 (УТC)

Итем

Тҳе item фунcтион оутпуц а рандом итем фром а лист.

{{#invoke:random|item|list item 1|list item 2|list item 3|...|same=yes}}

Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме итем ис ретурнед фор эач модуле cалл он а гивен паге.

Эхампле ()

• {{#invoke:random|item|egg|beans|sausage|bacon|spam}} → спам
• {{#invoke:random|item|egg|beans|sausage|bacon|spam|same=yes}} → эгг
• {{#invoke:random|item|egg|beans|sausage|bacon|spam|same=yes}} → эгг

Лист

Тҳе list фунcтион оутпуц а лист ин а рандом ордер.

{{#invoke:random|list|list item 1|list item 2|list item 3|...|sep=separator|limit=number of items to display|same=yes}}

Намед параметерс

• |сеп= ор |сепаратор= - ан оптионал сепаратор фор тҳе лист итемс. Соме валуэс аре спеcиал; сеэ тҳе табле белоw.
• |лимит= - тҳе махимум нумбер оф лист итемс то дисплай. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.
• |саме= - иф тҳис ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.

Поссибле сепаратор валуэс

Cоде	Оутпут
dot	·
pipe	|
comma	,
tpt-languages	⧼тпт-лангуагес-сепаратор⧽
space	а спаcе
newline	а неwлине чараcтер
анй отҳер валуэ	отҳер валуэс аре усед wитҳоут модифиcатион

Ёу cаннот инпут спаcес диреcтлй то тҳе |сеп= параметер дуэ то лимитатионс ин МедиаWики'с темплате сйнтах. Ҳоwевер, ит ис поссибле то wорк ароунд тҳис бй усинг ҲТМЛ энтитиэс. Ёу cан усе   то репресент а нормал спаcе, анд   то репресент а нон-бреакинг спаcе.

Эхамплес ()

• {{#invoke:random|list|egg|beans|sausage|bacon|spam}} → спамсаусагебаcонбеансегг
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=dot}} → саусаге · беанс · спам · баcон · эгг
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=space}} → саусаге беанс баcон спам эгг
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=; }} → саусаге; эгг; беанс; спам; баcон
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|sep=foo}} → баcонфооэггфооспамфообеансфоосаусаге
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|limit=3}} → спамбеансегг
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|same=yes}} → баcонбеанссаусагеспамегг
• {{#invoke:random|list|egg|beans|sausage|bacon|spam|same=yes}} → баcонбеанссаусагеспамегг

Техт лист

Тҳе text_list фунcтион оутпуц а лист ин а рандом ордер, техт-стйле. Ин отҳер wордс, ит ис лике тҳе list фунcтион, бут wитҳ а дифферент сепаратор бефоре тҳе ласт итем.

{{#invoke:random|text_list|list item 1|list item 2|list item 3|...|sep=separator|conj=conjunction|limit=number of items to display|same=yes}}

Тҳе сепаратор cан бе спеcифиэд wитҳ эитҳер тҳе |сеп= ор |сепаратор= параметерс; иц дефаулт валуэ ис ", ". Тҳе cонжунcтион cан бе спеcифиэд wитҳ эитҳер тҳе |cонж= ор |cонжунcтион= параметерс; иц дефаулт валуэ ис " анд ". Тҳе сепаратор анд тҳе cонжунcтион cан бе спеcифиэд wитҳ тҳе саме валуэс ас тҳе сепаратор ин тҳе лист фунcтион.

Тҳе махимум нумбер оф лист итемс то дисплай cан бе сет wитҳ тҳе |лимит= параметер. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.

Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.

Эхамплес ()

• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam}} → эгг, саусаге, беанс, спамва баcон
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|sep=; }} → спам; эгг; баcон; беансва саусаге
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|sep=; |conj= or }} → баcон; спам; саусаге; эгг ор беанс
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|limit=3}} → спам, беансва баcон
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → баcон, беанс, саусаге, спамва эгг
• {{#invoke:random|text_list|egg|beans|sausage|bacon|spam|same=yes}} → баcон, беанс, саусаге, спамва эгг

ҲТМЛ лисц

Иф ёу wиш то оутпут ан ҲТМЛ лист ин а рандом ордер, ёу cан чоосе бетwеэн фиве дифферент фунcтионс: bulleted_list, unbulleted_list, horizontal_list, ordered_list, анд horizontal_ordered_list. Тҳесе фунcтионс алл усе Модуле:Лист.

Фунcтион наме	Продуcес	Эхампле cоде	Эхампле оутпут ()
bulleted_list	Буллетед лисц	{{#invoke:random|bulleted_list|egg|sausage|spam}}	саусаге эгг спам
unbulleted_list	Унбуллетед лисц	{{#invoke:random|unbulleted_list|egg|sausage|spam}}	эгг спам саусаге
horizontal_list	Ҳоризонтал буллетед лисц	{{#invoke:random|horizontal_list|egg|sausage|spam}}	эгг саусаге спам
ordered_list	Ордеред лисц (нумберед лисц анд алпҳабетиcал лисц)	{{#invoke:random|ordered_list|egg|sausage|spam}}	саусаге эгг спам
horizontal_ordered_list	Ҳоризонтал ордеред лисц	{{#invoke:random|horizontal_ordered_list|egg|sausage|spam}}	эгг саусаге спам

Басиc усаге

{{#invoke:random|function|list item 1|list item 2|list item 3|...|limit=number of items to display|same=yes}}

Алл параметерс

Тҳе махимум нумбер оф лист итемс то дисплай cан бе сет wитҳ тҳе |лимит= параметер. Тҳе лоwест поссибле ис 0 анд тҳе ҳигҳест поссибле ис тҳе ленгтҳ оф тҳе лист.

Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе лист ордер ис тҳе саме фор эач модуле cалл он а гивен паге.

Плеасе сеэ Модуле:Лист фор а фулл эхпланатион оф тҳе отҳер параметерс.