Jump to content

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

From Ziyosfera

This is the documentation page for Modul:Random

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

Нумбер

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

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

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

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

Эхамплес (рефреш)

  • {{#invoke:random|number}} → 0.86529988463284
  • {{#invoke:random|number|100}} → 10
  • {{#invoke:random|number|-100|-50}} → -51
  • {{#invoke:random|number|100|same=yes}} → 58
  • {{#invoke:random|number|100|same=yes}} → 58

Тҳе до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)" (тҳе саме ас тҳе дефаулт ЗиёСфера тиместамп).
  • Тҳе тиместампс анд тҳе |формат= параметер аccепт валуэс cомпатибле wитҳ тҳе #тиме парсер фунcтион. Плеасе сеэ тҳе #тиме доcументатион фор тҳе фулл ранге оф поссибле инпут валуэс анд форматтинг оптионс.
  • Иф тҳе |саме= параметер ис сет то "ес", "й", "труэ", ор "1", тҳе саме дате ис ретурнед фор эач модуле cалл он а гивен паге.

Эхамплес (рефреш)

  • {{#invoke:random|date}} → 13:12, 29 ноябр 2026 (УТC)
  • {{#invoke:random|date|format=F j}} → июн 20
  • {{#invoke:random|date|1 Jan 1980|31 Dec 1999}} → 16:16, 11 август 1989 (УТC)
  • {{#invoke:random|date|1st January 1500|1st January 3000|format=g:i a, l d M Y}} → 6:30 пм, Шанба 19 дек 2995
  • {{#invoke:random|date|1970/06/01}} → 16:22, 29 март 1970 (УТC)
  • {{#invoke:random|date|same=yes}} → 18:53, 30 июл 2026 (УТC)
  • {{#invoke:random|date|same=yes}} → 18:53, 30 июл 2026 (УТ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}}
  1. эгг
  2. спам
  3. саусаге
horizontal_ordered_list Ҳоризонтал ордеред лисц {{#invoke:random|horizontal_ordered_list|egg|sausage|spam}}
  1. саусаге
  2. спам
  3. эгг
Басиc усаге
{{#invoke:random|function|list item 1|list item 2|list item 3|...|limit=number of items to display|same=yes}}
Алл параметерс
{{#invoke:random|''function''
|''first item''|''second item''|''third item''|...
|start           = ''start number for ordered lists''
|type            = ''type of marker for ordered lists''
|list_style_type = ''type of marker for ordered lists (uses CSS)''
|class           = ''class''
|style           = ''style''
|list_style      = ''style for the list''
|item_style      = ''style for all list items''
|item_style1     = ''style for the first list item'' |item_style2 = ''style for the second list item'' |...
|indent          = ''indent for horizontal lists''
}}

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

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

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