วิธีใช้:ส่วนขยาย:ParserFunctions

ส่วนขยาย ParserFunctions จะเพิ่มฟังก์ชันตัวแยกวิเคราะห์สําหรับรองรับ "{{2ドル|เมจิกเวิร์ด}}" ซึ่งมีอยู่ในมีเดียวิกิอยู่แล้ว (See คู่มือ:คําพิเศษ .) (อาจตั้งค่าเพื่อให้มีฟังก์ชันตัวแยกวิเคราะห์สําหรับการจัดการกับสตริงเพิ่มเติม แต่การบ่งชี้การใช้ระบุไว้ที่อื่น ) ตัวแยกวิเคราะห์ทั้งหมดที่มาจากส่วนขยายนี้จะอยู่ในรูปแบบดังนี้:

{{#ชื่อฟังก์ชัน: อาร์กิวเมนต์ ก | อาร์กิวเมนต์ ข | อาร์กิวเมนต์ ค | ... }}

ฟังก์ชันนี้จะดําเนินการทางคณิตศาสตร์และส่งค่าที่ผ่านการคํานวณแล้วส่งค่าที่ได้กลับ ฟังก์ชันนี้ยังมีอยู่ใน Scribunto ผ่านฟังก์ชัน mw.ext.ParserFunctions.expr

{{#expr: นิพจน์ }}

Basic example

{{#expr: 1 + 1 }} → 2

ตัวดําเนินการที่สามารถใช้งานได้จะรายการอยู่ทางขวามือ เรียงลําดับตามลําดับการดําเนินการตรรกศาสตร์ ดู[[Manual:Expr parser function syntax |วิธีใช้:การคํานวณ]]สําหรับรายละเอียดเพิ่มเติมของแต่ละตัวดําเนินการ ความถูกต้องและรูปแบบจะขึ้นอยู่กับระบบปฏิบัติการของเซิร์ฟเวอร์ที่ดําเนินการวิกิและรูปแบบตัวเลขที่ระบุโดยแต่ละภาษา The accuracy and format of the result returned will vary depending on the operating system of the server running the wiki and the number format of the site language.

เมื่อมีการเรียกใช้งานโดยใช้พีชคณิตแบบบูล ศูนย์จะหมายถึง false (เท็จ) และจํานวนเต็มบวก เต็มลบ และทศนิยมอื่น ๆ ทั้งหมดที่ไม่ใช่ศูนย์ จะหมายถึง true (จริง):

{{#expr: 1 and -1 }} → 1

{{#expr: 1 and 0 }} → 0

{{#expr: 1 or -1 }} → 1

{{#expr: -1 or 0 }} → 1

{{#expr: 0 or 0 }} → 0

การส่งค่านิพจน์ว่างจะส่งกลับสตริงว่าง นิพจน์ที่ไม่ถูกต้องจะส่งกลับหนึ่งในหลายสารแสดงข้อผิดพลาด ซึ่งสามารถตรวจจับได้โดยใช้ฟังก์ชัน #iferror :

{{#expr: }} →

{{#expr: 1+ }} → Expression error: Missing operand for +.

{{#expr: 1 = }} → Expression error: Missing operand for =.

{{#expr: 1 foo 2 }} → Expression error: Unrecognized word "foo".

การใส่ตัวดําเนินการบวกและการลบทั้งก่อนหรือหลังตัวเลขนั้นมีนัย และอาจถือเป็นจํานวนบวกหรือจํานวนลบ แทนการส่งกลับข้อผิดพลาดว่าเป็นการใช้งานผิดพลาด:

{{#expr: +1 }} → 1

{{#expr: -1 }} → -1

{{#expr: + 1 }} → 1

{{#expr: - 1 }} → -1

หมายเหตุ หากคุณกําลังจะใช้งานค่าส่งกลับจากเมจิกเวิร์ดเหล่านี้ คุณต้องทําให้อยู่ในรูปตัวเลขดิบเพื่อลบคอมมาและการแปลงตัวเลขออก ตัวอย่างเช่น $numberofusers จะแสดงผลเป็น $nou-result แต่เราต้องการค่าแบบ $nou-result-raw ซึ่งสามารถทําได้โดยใช้ $numberofusers2 ซึ่งบางครั้งมักจําเป็นต้องใช้ในบางภาษาที่ตัวเลขถูกแปลง เช่นในภาษาเบงกาลี $numberofusers3 จะได้ค่าเป็น $bengali For example, {{NUMBEROFUSERS}} results in 18,480,185, where we want 18480185, which can be obtained using {{formatnum :{{NUMBEROFUSERS}}|R}}. This is especially important in some languages, where numerals are translated. For example, in Bengali, {{NUMBEROFUSERS}} produces ৩০,০৬১.

{{#expr:{{NUMBEROFUSERS}}+100}} → Expression error: Unrecognized punctuation character ",".

{{#expr:{{formatnum:{{NUMBEROFUSERS}}|R}}+100}} → 18480285

ปัดเศษทศนิยมทางซ้ายมือตัวดําเนินการเพื่อให้เหลือจํานวนเท่ากับตัวเลขทางขวามือตัวดําเนินการ

สําหรับการปัดขึ้นหรือปัดลง ใช้การดําเนินการเอกภาค ceil หรือ floor ตามลําดับ

นิพจน์จะทํางานเฉพาะกับค่าที่คล้ายเป็นตัวเลขเท่านั้น โดยไม่สามารถใช้เปรียบเทียบสตริงหรืออักขระได้ กรณีนั้นควรใช้ #ifeq แทน

{{#expr: "a" = "a" }} → Expression error: Unrecognized punctuation character """.

{{#expr: a = a }} → Expression error: Unrecognized word "a".

{{#ifeq: a | a | 1 | 0 }} → 1

ฟังก์ชันนี้ใช้กระเมินสตริงที่ทดสอบว่าเป็นค่าว่างหรือไม่ หากสตริงที่ทดสอบมีเพียงไวต์สเปซจะถือว่าเป็นค่าว่างเช่นกัน

{{#if: สตริงทดสอบ | ค่าหากสตริงที่ทดสอบไม่ใช่ค่าว่าง | ค่าหากสตริงทดสอบเป็นค่าว่าง (หรือมีเฉพาะไวต์สเปซ)}}

{{#if: พารามิเตอร์แรก | พารามิเตอร์ที่สอง | พารามิเตอร์ที่สาม }}

ฟังก์ชันนี้จะทดสอบว่าพารามิเตอร์แรกจะไม่ใช่ค่าว่าง หากพารามิเตอร์แรกไม่ใช่ค่าว่าง จะแสดงผลพารามิเตอร์ที่สอง หากพารามิเตอร์แรกเป็นค่าว่างหรือมีแค่ไวต์สเปซ จะแสดงพารามิเตอร์ที่สาม

{{#if: | yes | no}} → no

{{#if: string | yes | no}} → yes

{{#if:      | yes | no}} → yes

{{#if: 1==2 | yes | no }} → yes

{{#if: 0 | yes | no }} → yes

พารามิเตอร์สุดท้าย (เท็จ) ไม่จําเป็น อาจนําออกก็ได้:

{{#if: foo | yes }} → yes

{{#if: | yes }} →

{{#if: foo | | no}} →

ฟังก์ชันอาจซ้อนกันได้ ในการทําเช่นนั้น ซ้อน #if ด้านในในรูปแบบเต็มในจุดที่พารามิเตอร์ปิดฟังก์ชัน #if สามารถซ้อนกันได้สูงสุด 7 ระดับ ซึ่งในหลายกรณีจะขึ้นอยู่กับตัววิกิหรือขีดจํากัดหน่วยความจําของวิกิ

{{#if:สตริงทดสอบ
| ค่าหากสตริงที่ทดสอบไม่ใช่ค่าว่าง
|{{#if:test string
 |value if test string is not empty
 |ค่าหากสตริงทดสอบเป็นค่าว่าง (หรือมีเฉพาะไวต์สเปซ)
 }}
}}

ใน #if คุณยังสามารถใช้พารามิเตอร์เป็นสตริงทดสอบได้ด้วย แต่ต้องใส่ 1ドル (ไปป์) หลังชื่อพารามิเตอร์เสมอ You need to ensure you add the | (pipe symbol) after the name of the variable. (ดังนั้น หากพารามิเตอร์ไม่ได้ระบุค่า พารามิเตอร์จะส่งค่าว่างแทนสตริง "{{{1}}}")

{{#if:{{{1|}}}|คุณใส่ค่าข้อความในตัวแปร 1|ตัวแปร 1 ไม่มีข้อความใด ๆ}}

ดูที่ Help:Parser functions in templates สําหรับตัวอย่างเพิ่มเติมเกี่ยวกับฟังก์ชันตัวแยกวิเคราะห์นี้

ฟังก์ชันตัวแยกวิเคราะห์นี้จะเทียบเคียงสองสตริงที่ป้อนเข้า มาตรวจสอบว่าตรงกันหรือไม่ แล้วส่งกลับหนึ่งในสองสตริงตามผลลัพธ์ที่ได้ หากต้องใช้การเปรียบเทียบจํานวนมากและส่งกลับค่าตามการเทียบ พิจารณาใช้ #switch แทน

{{#ifeq: string 1 | string 2 | value if identical | value if different }}

หากสตริงทั้งคู่เป็นค่าตัวเลขที่ถูกต้อง สตริงนั้นจะถูกเปรียบเทียบในเชิงคณิตศาสตร์แทน

{{#ifeq: 01 | 1 | equal | not equal}} → equal

{{#ifeq: 0 | -0 | equal | not equal}} → equal

{{#ifeq: 1e3 | 1000 | equal | not equal}} → equal

{{#ifeq: {{#expr:10^3}} | 1000 | equal | not equal}} → equal

แต่หากไม่ใช่จะถือว่าเป็นข้อความ และการเปรียบเทียบจะไวต่ออักษรเล็กใหญ่

{{#ifeq: foo | bar | equal | not equal}} → not equal

{{#ifeq: foo | Foo | equal | not equal}} → not equal

{{#ifeq: "01" | "1" | equal | not equal}} → not equal (เปรียบเทียบกับตัวอย่างที่คล้ายกันด้านบนโดยไม่ใส่อัญประกาศ)

{{#ifeq: 10^3 | 1000 | equal | not equal}} → not equal (เทียบกับตัวอย่างที่คล้ายกันด้านบน กับ #expr จะส่งกลับค่าตัวเลขที่ถูกต้องก่อน)

เพื่อให้เห็นภาพ ลองพิจารณาแม่แบบ แม่แบบ:Timer โดยจะใช้ตัวแยกวิเคราะห์เพื่อเลือกระหว่างเวลามาตรฐานสองอัน เวลาชั่วครู่สั้น และเวลาที่นานกว่า โดยจะใช้พารามิเตอร์ 1 เป็นตัวป้อนค่าในอาร์กิวเมนต์แรก หากไม่ตรงกับสตริง "short" หมายเหตุว่าลําดับไม่มีผล อาจสลับกันได้ แต่จะสะดวกกว่าหากใช้พารามิเตอร์เป็นอาร์กิวเมนต์แรก โค้ดแม่แบบจะเป็น:

{{#ifeq: {{{1|}}} | short | 20 | 40 }}

จะได้ผลลัพธ์:

{{timer|short}} → 20

{{timer|20}} → 40

{{timer}} → 40

ฟังก์ชันนี้จะรับค่าสตริงเข้าแล้วส่งค่ากลับหนึ่งในสองความเป็นไปได้ ฟังก์ชันจะส่งกลับค่า true หากสตริงนําเช้ามีอ็อบเจค HTML ที่มี class="error" ซึ่งถูกสร้างโดยฟังก์ชันแยกวิเคราะห์อื่น ๆ เช่น #expr , #time และ #rel2abs , ข้อผิดพลาดแ่แบบแม่แบบ เช่นวังวนแม่แบบและแม่แบบซ้อน และข้อผิดพลาดตัวแยกวิเคราะห์อื่น ๆ ที่เป็น "failsoft"

{{#iferror: test string | value if error | value if correct }}

หนึ่งหรือสองค่าที่ส่งกลับสามารถละเว้นได้ หากละเว้นการใส่สตริง correct test string จะส่งกลับหากไม่ใช่ค่าที่เป็นข้อผิดพลาด และหากละเว้นการใส่สตริง error เมื่อเกิดข้อผิดพลาดจะส่งกลับค่าว่างออกมา: If the correct string is omitted, the test string is returned if it is not erroneous. If the error string is also omitted, an empty string is returned on an error:

{{#iferror: {{#expr: 1 + 2 }} | error | correct }} → correct

{{#iferror: {{#expr: 1 + X }} | error | correct }} → error

{{#iferror: {{#expr: 1 + 2 }} | error }} → 3

{{#iferror: {{#expr: 1 + X }} | error }} → error

{{#iferror: {{#expr: 1 + 2 }} }} → 3

{{#iferror: {{#expr: 1 + X }} }} → ‌

{{#iferror: {{#expr: . }} | error | correct }} → correct

{{#iferror: <strongclass="error">a</strong> | error | correct }} → error

Some errors may cause a tracking category to be added, using {{#iferror:}} will not suppress the addition of the category.

ฟังก์ชันนี้มีการประเมินนิพจน์ทางคณิตศาสตร์และส่งกลับสตริงหนึ่งในสองค่าขึ้นอยู่กับค่าความจริงของผลลัพธ์:

{{#ifexpr: expression | value if true | value if false }}

หากป้อนค่าว่าง จะถูกประเมินเป็น false:

{{#ifexpr: | yes | no}} → no

ดังที่ได้กล่าวถึงข้างต้น ค่าศูนย์จะถือว่าเป็น false และค่าอื่น ๆ ทั้งหมดจะเป็น true ดังนั้นฟังก์ชันนี้เทียบเท่ากับการใช้เพียง #ifeq และ #expr :

{{#ifeq: {{#expr: expression }} | 0 | value if false | value if true }}

{{#ifexpr: = | yes | no }} → Expression error: Unexpected = operator.

เปรียบเทียบ

{{#ifeq: {{#expr: = }} | 0 | no | yes }} → yes

ค่าที่ต้องส่งออกค่าใดค่าหนึ่งหรือทั้งสองค่าสามารถละเว้นได้ จะไม่ส่งกลับค่าใด ๆ หากช่องที่ต้องส่งออกเป็นค่าว่าง

{{#ifexpr: 1 > 0 | yes }} → yes

{{#ifexpr: 1 < 0 | yes }} →

{{#ifexpr: 0 = 0 | yes }} → yes

{{#ifexpr: 1 > 0 | | no}} →

{{#ifexpr: 1 < 0 | | no}} → no

{{#ifexpr: 1 > 0 }} →

Boolean operators of equality or inequality operators are supported.

{{#ifexpr: 0 = 0 or 1 = 0 | yes}} → yes

{{#ifexpr: 0 = 0 and 1 = 0 | | no}} → no

{{#ifexpr: 2 > 0 or 1 < 0 | yes}} → yes

{{#ifexpr: 2 > 0 and 1 > 0 | yes | no}} → yes

ฟังก์ชันนี้รับค่าสตริง ตีความว่าได้รับค่าหน้า แล้วส่งค่ากลับหนึ่งในสองค่า ขึ้นอยู่กับว่าหน้าที่ได้รับนั้นมีอยู่หรือไม่ในวิกิท้องถิ่น

{{#ifexist: page title | value if exists | value if doesn't exist }}

ฟังก์ชันจะเป็น จริง เมื่อหน้ามีอยู่ ไม่ว่าจะมีเนื้อหาหรือไม่ หรือไม่แสดงผล (เช่นลิงก์หมวดหมู่หรือคําพิเศษ แต่ไม่มีเนื้อหาที่มองเห็นได้) หรือเป็นหน้าเปลี่ยนทาง เฉพาะหน้าที่เมื่อเขียนลิงก์แล้วเป็นลิงก์แดงเท่านั้นที่จะเป็น เท็จ รวมถึงหน้าที่เคยมีอยู่แต่บังเอิญเพิ่งถูกลบเช่นกัน Only pages that are redlinked evaluate to false, including if the page used to exist but has been deleted.

{{#ifexist: Help:Extension:ParserFunctions/th | exists | doesn't exist }} → exists

{{#ifexist: XXHelp:Extension:ParserFunctions/thXX | exists | doesn't exist }} → doesn't exist

{{#ifexist: Special:Watchlist | exists | doesn't exist }} → exists

{{#ifexist: Special:CheckUser | exists | doesn't exist }} → exists (because the Checkuser extension is installed on this wiki)

{{#ifexist: MediaWiki:Copyright | exists | doesn't exist }} → doesn't exist (because MediaWiki:Copyright has not been customized)

Prior to MediaWiki 1.45 if a page checks a target using #ifexist:, then that page will appear in the Special:WhatLinksHere list for the target page. So if the code {{#ifexist:Foo }} were included live on this page (Help:Extension:ParserFunctions/th), Special:WhatLinksHere/Foo will list Help:Extension:ParserFunctions/th.

{{#ifexist: File:Example.png | exists | doesn't exist }} → doesn't exist

{{#ifexist: Image:Example.png | exists | doesn't exist }} → doesn't exist

{{#ifexist: Media:Example.png | exists | doesn't exist }} → exists

#ifexist: is considered an "expensive parser function"; only a limited number of which can be included on any one page (including functions inside transcluded templates). When this limit is exceeded, any further #ifexist: functions automatically return false, whether the target page exists or not, and the page is categorized into Category:Pages with too many expensive parser function calls. The name of the tracking category may vary depending on the content language of your wiki.

For some use cases it is possible to emulate the ifexist effect with css, by using the selectors a.new (to select links to nonexistent pages) or a:not(.new) (to select links to existing pages). Furthermore, since the number of expensive parser functions that can be used on a single page is controlled by $wgExpensiveParserFunctionLimit , one can also increase the limit in LocalSettings.php if needed.

Prior to MediaWiki 1.45, a page that does not exist and is tested for using #ifexist will end up on the Wanted Pages. See T14019 for the reason, and w:Template:Linkless exists for a workaround.

{{#rel2abs: path }}

{{#rel2abs: path | base path }}

• . → the current level
• .. → go up one level
• /foo → go down one level into the subdirectory /foo

{{#rel2abs: /quok | Help:Foo/bar/baz }} → Help:Foo/bar/baz/quok

{{#rel2abs: ./quok | Help:Foo/bar/baz }} → Help:Foo/bar/baz/quok

{{#rel2abs: ../quok | Help:Foo/bar/baz }} → Help:Foo/bar/quok

{{#rel2abs: ../. | Help:Foo/bar/baz }} → Help:Foo/bar

Invalid syntax, such as /. or /./, is ignored. Since no more than two consecutive full stops are permitted, sequences such as these can be used to separate successive statements:

{{#rel2abs: ../quok/. | Help:Foo/bar/baz }} → Help:Foo/bar/quok

{{#rel2abs: ../../quok | Help:Foo/bar/baz }} → Help:Foo/quok

{{#rel2abs: ../../../quok | Help:Foo/bar/baz }} → quok

{{#rel2abs: ../../../../quok | Help:Foo/bar/baz }} → ข้อผิดพลาด: ความลึกพาธไม่ถูกต้อง: "Help:Foo/bar/baz/../../../../quok" (พยายามที่จะเข้าถึงตําแหน่งที่อยู่เหนือขึ้นไปจาก)

For a similar group of functions see also Help:Magic words#URL data. Built-in parser functions include: 'localurl:', 'fullurl:', 'anchorencode:' etc.

See also: w:Help:Switch parser function

{{#switch: comparison string
 | case = result
 | case = result
 | ...
 | case = result
 | default result
}}

{{#switch: baz | foo = Foo | baz = Baz | Bar }} → Baz

{{#switch: foo | foo = Foo | baz = Baz | Bar }} → Foo

{{#switch: zzz | foo = Foo | baz = Baz | Bar }} → Bar

{{#switch: test | foo = Foo | baz = Baz | Bar }} → Bar

In this syntax, the default result must be the last parameter and must not contain a raw equals sign (an equals sign without {{}}). If it does, it will be treated as a case comparison, and no text will display if no cases match. This is because the default value has not been defined (is empty). If a case matches however, its associated string will be returned.

{{#switch: test | Bar | foo = Foo | baz = Baz }} →

{{#switch: test | foo = Foo | baz = Baz | B=ar }} →

{{#switch: test | test = Foo | baz = Baz | B=ar }} → Foo

{{#switch: comparison string
 | case = result
 | case = result
 | ...
 | case = result
 | #default = default result
}}

{{#switch: test | foo = Foo | #default = Bar | baz = Baz }} → Bar

{{#switch: test | foo = Foo | baz = Baz }} →

{{#switch: comparison string
 | case1 = result1
 | case2 
 | case3 
 | case4 = result234
 | case5 = result5
 | case6 
 | case7 = result67
 | #default = default result
}}

Here cases 2, 3 and 4 all return result234; cases 6 and 7 both return result67. The "#default = " in the last parameter may be omitted in the above case.

The function may be used with parameters as the test string. In this case, it is not necessary to place the pipe after the parameter name, because it is very unlikely that you will choose to set a case to be the string "{{{parameter name}}}". (This is the value the parameter will default to if the pipe is absent and the parameter doesn't exist or have a value. See Help:Parser functions in templates .)

{{#switch: {{{1}}} | foo = Foo | baz = Baz | Bar }}

In the above case, if {{{1}}} equals foo, the function will return Foo. If it equals baz, the function will return Baz. If the parameter is empty or does not exist, the function will return Bar.

{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | Bar }}

Here, if {{{1}}} equals foo, zoo or roo, the function will return Foo. If it equals baz, the function will return Baz. If the parameter is empty or does not exist, the function will return Bar.

{{#switch: {{{1}}} | foo = Foo | bar = Bar }}

{{#switch: {{{1}}} | foo | zoo | roo = Foo | baz = Baz | }}

If you decide to set a case as "{{{parameter name}}}", the function will return that case's result when the parameter doesn't exist or doesn't have a value. The parameter would have to exist and have a value other than the string "{{{parameter name}}}" to return the function's default result.

(when {{{1}}} doesn't exist or is empty):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Foo

(when {{{1}}} has the value "test"):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Bar

(when {{{1}}} has the value "{{{1}}}"):

{{#switch: {{{1}}} | {{{1}}} = Foo | baz = Baz | Bar }} → Foo

{{#switch: 0 + 1 | 1 = one | 2 = two | three}} → three

{{#switch: {{#expr: 0 + 1}} | 1 = one | 2 = two | three}} → one

{{#switch: 02 | +1 = one | +2 = two | three}} → two

{{#switch: 100 | 1e1 = ten | 1e2 = hundred | other}} → hundred

{{#switch: a | a = A | b = B | C}} → A

{{#switch: A | a = A | b = B | C}} → C

{{#switch: |= Nothing | foo = Foo | Something }} → Nothing

{{#switch: b | f = Foo | b = Bar | b = Baz | }} → Bar

{{#switch: 1=2
 | 1=2 = raw
 | 1<nowiki>=</nowiki>2 = nowiki
 | 1{{=}}2 = template
 | default
}}

{{#switch: 1=2
 | 1=2 = html
 | default
}}

• {{#switch:{{{1}}} |condition1=branch1 |condition2=branch2 |condition3=branch3 |branch4}}

• {{#ifeq:{{{1}}}|condition1 |branch1 |{{#ifeq:{{{1}}}|condition2 |branch2 |{{#ifeq:{{{1}}}|condition3 |branch3 |branch4}}}}}}

{{#ifeq:{{{1}}}|condition1
 |<!--then-->branch1
 |<!--else-->{{#ifeq:{{{1}}}|condition2
 |<!--then-->branch2
 |<!--else-->{{#ifeq:{{{1}}}|condition3
 |<!--then-->branch3
 |<!--else-->branch4}}}}}}

{{#ifeq:{{{1}}}|condition1
 |<!--then-->branch1t{{
#ifeq:{{{1}}}|condition2
 |<!--then-->branch1t2t{{#ifeq:{{{1}}}|condition4|<!--then-->branch1t2t4t|<!--else-->branch1t2t4e}}
 |<!--else-->branch1t2e{{#ifeq:{{{1}}}|condition5|<!--then-->branch1t2e5t|<!--else-->branch1t2e5e}}
 }}
 |<!--else-->branch1e{{#ifeq:{{{1}}}|condition3
 |<!--then-->branch1e3t{{#ifeq:{{{1}}}|condition6|branch1e3t6t|branch1e3t6e}}
 |<!--else-->branch1e3e{{
#ifeq:{{{1}}}|condition7
 |branch1e3e7t
 |branch1e3e7t
 }}
 }}
}}

{{#time: format string }}

{{#time: format string | date/time object }}

{{#time: format string | date/time object | language code }}

{{#time: format string | date/time object | language code | local }}

The list of accepted formatting codes is given in the table to the right. Any character in the formatting string that is not recognized is passed through unaltered; this applies also to blank spaces (the system does not need them for interpreting the codes). If no character is recognized in the formatting string, and the date/time object is without error, then the formatting string is returned as output. There are also two ways to escape characters within the formatting string:

1. A backslash followed by a formatting character is interpreted as a single literal character
2. Characters enclosed in double quotes are considered literal characters, and the quotes are removed.

Unfortunately, for now, the ASCII single quote is still not recognized as a simple alternative for marking literal text to the currently supported ASCII double quotes (for example, double quotes are mandatory for in other uses like the delimitation of string values in JSON, C, C++...) and backslashes (which have to be escaped as well in string constants used by many languages, including JSON, C, C++, PHP, JavaScript, Lua). So you still cannot embed any literal double quote without escaping it with a backslash (or you can use other curly, angular or square quotation marks instead).

{{#time: Y-m-d }} → 2026年08月13日

{{#time: [[Y]] m d }} → 2026 08 13

{{#time: [[Y (year)]] }} → 2026 (26UTCpmThu, 13 Aug 2026 16:22:40 +0000)

{{#time: [[Y "(year)"]] }} → 2026 (year)

{{#time: i's" }} → 22'40"

The date/time object can be in any format accepted by PHP's strtotime() function. Absolute (e.g. 20 December 2000), relative (e.g. +20 hours), and combined times (e.g. 30 July +1 year) are accepted.

{{#time: r|now}} → 2026年8月13日 16:22:40 +0000

{{#time: r|+2 hours}} → 2026年8月13日 18:22:40 +0000

{{#time: r|now + 2 hours}} → 2026年8月13日 18:22:40 +0000

{{#time: r|20 December 2000}} → 2000年12月20日 00:00:00 +0000

{{#time: r|December 20, 2000}} → 2000年12月20日 00:00:00 +0000

{{#time: r|2000年12月20日}} → 2000年12月20日 00:00:00 +0000

{{#time: r|2000 December 20}} → ข้อผิดพลาด: เวลาไม่ถูกต้อง

{{#time: r|last tuesday}} → 2026年8月11日 00:00:00 +0000

{{#time:d F Y|1988年02月28日|nl}} → 28 februari 1988

{{#time:l|now|uk}} → четвер

{{#time:d xg Y|20 June 2010|pl}} → 20 czerwca 2010

{{#time: Y F d H:i:s|now|it|0}} → 2026 agosto 13 16:22:40

{{#time: Y F d H:i:s|now|it|1}} → 2026 agosto 13 16:22:40

{{#time: Y F d H:i:s|+2 hours||0}} → 2026 สิงหาคม 13 18:22:40

{{#time: Y F d H:i:s|+2 hours||1}} → 2026 สิงหาคม 13 18:22:40

{{#time:c|2019年05月16日T17:05:43+02:00|it}} → 2019年05月16日T15:05:43+00:00

{{#time:c|2019年05月16日T17:05:43+02:00|it|0}} → 2019年05月16日T15:05:43+00:00

{{#time:c|2019年05月16日T17:05:43+02:00|it|true}} → 2019年05月16日T15:05:43+00:00

{{#time: U | now }} → 1786638160

{{#time: r | @1786638160 }} → 2026年8月13日 16:22:40 +0000

{{#time: Y | January 1 }} → 2026

{{#time: Y m d H:i:s | 1959 }} → 1959 08 13 00:00:00

{{#time: Y m d H:i:s | 195909 }} → 2026 08 13 19:59:09 Input is treated as a time rather than a year+month code.

{{#time: Y m d H:i:s | 196009 }} → ข้อผิดพลาด: เวลาไม่ถูกต้อง Although 19:60:09 is not a valid time, 196009 is not interpreted as September 1960.

{{#time: d F Y | January 0 2008 }} → 31 ธันวาคม 2007

{{#time: d F | January 32 }} → ข้อผิดพลาด: เวลาไม่ถูกต้อง

{{#time: d F | February 29 2008 }} → 29 กุมภาพันธ์

{{#time: d F | February 29 2007 }} → 01 มีนาคม

{{#time:Y-F|now -1 months}} → 2026-กรกฎาคม

The total length of the format strings of the calls of #time is limited to 6000 characters. If exceeded, the following error message is displayed instead: ข้อผิดพลาด: มีการเรียกใช้ #time มากเกินไป^[2]

• {{#time:g:i A | -4 hours }} → 12:22 PM

• {{#time:g:i A | +5.5 hours }} → 4:22 PM

• {{#time:g:i A | +330 minutes }} → 9:52 PM
• {{#time:g:i A | +19800 seconds }} → 9:52 PM

Sometimes it is useful to construct a timestamp, which looks like the automatic timestamp generated by signatures in discussions on talk pages. On an English-language wiki, it can be created with:

• {{#timel:H:i, j xg Y (e)|+330 minutes}} → 21:52, 13 สิงหาคม 2026 (UTC)

{{#timel: format string }}

{{#timel: format string | date/time object }}

{{#timel: format string | date/time object | language code }}

{{#time:c|now|it}} → 2026年08月13日T16:22:40+00:00

{{#time:c|now|it|0}} → 2026年08月13日T16:22:40+00:00

{{#time:c|now|it|1}} → 2026年08月13日T16:22:40+00:00

{{#timel:c|now|it}} → 2026年08月13日T16:22:40+00:00

This function formats a date using a standard format for the selected language, as defined in $dateFormats (see T223772).

{{#timef: date/time object }}

{{#timef: date/time object | format type }}

{{#timef: date/time object | format type | language code }}

time

Only the time is shown.

date

Only the date is shown.

both

Both the time and date are shown.

pretty

Only the date is shown, using an abbreviated format which does not include the year. Not all languages support this; if it is not supported, the "date" format is used.

{{#timef:now|both|en}} → 16:22, 13 August 2026

{{#timef:now|both|ja}} → 2026年8月13日 (木) 16:22

{{#timef:now|pretty|en}} → 13 August

{{#timef:now|pretty|pl}} → 13 sierpnia

{{#timef:|time}} → 16:22

This function is the same as #timef except that it uses the local timezone of the wiki as configured in $wgLocaltimezone .

{{#timefl: date/time object }}

{{#timefl: date/time object | format type }}

{{#timefl: date/time object | format type | language code }}

{{#titleparts: pagename | number of segments to return | segment to start at }}

{{#titleparts: Talk:Foo/bar/baz/quok }} → Talk:Foo/bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | 1 }} → Talk:Foo See also {{ROOTPAGENAME }}.

{{#titleparts: Talk:Foo/bar/baz/quok | 2 }} → Talk:Foo/bar

{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 2 }} → bar/baz

{{#titleparts: Talk:Foo/bar/baz/quok | 2 | 3 }} → baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | 3 | 2 }} → bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | | 2 }} → bar/baz/quok

{{#titleparts: Talk:Foo/bar/baz/quok | | 5 }} →

{{#titleparts: Talk:Foo/bar/baz/quok | -1 }} → Talk:Foo/bar/baz Strips one segment from the end of the string. See also BASEPAGENAME .

{{#titleparts: Talk:Foo/bar/baz/quok | -4 }} → Strips all 4 segments from the end of the string

{{#titleparts: Talk:Foo/bar/baz/quok | -5 }} → Strips 5 segments from the end of the string (more than exist)

{{#titleparts: Talk:Foo/bar/baz/quok | | -1 }} → quok Returns last segment. See also SUBPAGENAME .

{{#titleparts: Talk:Foo/bar/baz/quok | -1 | 2 }} → bar/baz Strips one segment from the end of the string, then returns the second segment and beyond

{{#titleparts: Talk:Foo/bar/baz/quok | -1 | -2 }} → baz Start copying at the second last element; strip one segment from the end of the string

For example, any occurrence of ", ", or " in pagename will be replaced by ".

No other conversion from HTML to plain text is performed, so HTML tags are left intact at this initial step even if they are invalid in page titles.

1. All underscores are automatically replaced with spaces:

   {{#titleparts: Talk:Foo/bah_boo|1|2}} → bah boo Not bah_boo, despite the underscore in the original.

2. The string is split a maximum of 25 times; further slashes are ignored and the 25th element will contain the rest of the string. The string is also limited to 255 characters, as it is treated as a page title:

   {{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee | 1 | 25 }} → y/z/aa/bb/cc/dd/ee

   If for whatever reason you needed to push this function to its limit, although very unlikely, it is possible to bypass the 25 split limit by nesting function calls:

   {{#titleparts: {{#titleparts: a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/aa/bb/cc/dd/ee| 1 | 25 }} | 1 | 2}} → z

3. Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).

   {{#titleparts: talk:a/b/c }} → Talk:A/b/c

The ParserFunctions extension optionally defines various string functions if $wgPFEnableStringFunctions is set to true:

• #len
• #pos
• #rpos
• #sub
• #count
• #replace
• #explode
• #urldecode

See the dedicated subpage for documentation, and Manual:Performing string operations with parser functions for examples.

Here is a short overview of Module:String functions:

• #len (length of string) - {{#invoke:String|len|target_string}}
• #sub (substring) - {{#invoke:String|sub|target_string|start_index|end_index}}
• #match: {{#invoke:String|match|source_string|pattern_string|start_index|match_number|plain_flag|nomatch_output}}
• #pos (position of target) - {{#invoke:String|pos|target_string|index_value}}
• #find: {{#invoke:String|find|source_string|target_string|start_index|plain_flag}}
• #replace: {{#invoke:String|replace|source_str|pattern_string|replace_string|replacement_count|plain_flag}}
• #rep (repeat) - {{#invoke:String|rep|source|count}}
• #escapePattern: {{#invoke:String|escapePattern|pattern_string}}
• #count: {{#invoke:String|count|source_str|pattern_string|plain_flag}}
• #join: {{#invoke:String|join|separator|string1|string2|...}}

{{subst:#ifexist: Help:Extension:ParserFunctions/th | [[Help:Extension:ParserFunctions/th]] | Help:Extension:ParserFunctions/th }} → the code [[Help:Extension:ParserFunctions/th]] will be inserted in the wikitext since the page Help:Extension:ParserFunctions/th exists.

Parser functions will mangle wikitable syntax and pipe characters (|), treating all the raw pipe characters as parameter dividers. To avoid this, most wikis used a template Template:! with its contents only a raw pipe character (|), since MW 1.24 a {{!}} magic word replaced this kludge. This 'hides' the pipe from the MediaWiki parser, ensuring that it is not considered until after all the templates and variables on a page have been expanded. It will then be interpreted as a table row or column separator. Alternatively, raw HTML table syntax can be used, although this is less intuitive and more error-prone.

{{!}}

|

{{Documentation
|content=
... text before ...<code>subpage-name=sandbox3</code> is equivalent to <code>sandbox link=../sandbox3 | sandbox name=sandbox3</code>.
... text after ...
}}

{{#ifeq: foo | foo | equal | not equal }} → equal

{{#ifeq: "foo " | " foo" | equal | not equal }} → not equal

To prevent the trimming of then and else parts, see m:Template:If. Some people achieve this by using <nowiki > </nowiki> instead of spaces.

foo{{#if:|| bar }}foo → foobarfoo

foo{{#if:||<nowiki/>bar<nowiki/>}}foo → foo bar foo

<span style="white-space: pre;">foo{{#if:||<nowiki/> bar <nowiki/>}}foo</span>

→ foo bar foo

<span style="white-space: pre;">foo{{#if:||&#32;&#32;&#32;bar&#32;&#32;&#32;}}foo</span> → foo bar foo

foo{{#if:||   bar   }}foo → foo bar foo

Beware that not all parameters are created equal. In ParserFunctions, whitespace at the beginning and end is always stripped. In templates , whitespace at the beginning and end is stripped for named parameters and named unnamed parameters but not from unnamed parameters:

foo{{1x|content= bar}}foo → foobarfoo

foo{{1x|1= bar}}foo → foobarfoo

foo{{1x| bar }}foo → foo bar foo

• Lowercase: "{{lc: AbC}}" → "abc" [1]
• Uppercase: "{{uc: AbC}}" → "ABC" [2]
• Lowercase first character: "{{lcfirst: AbC}}" → "abC" [3]
• Uppercase first character: "{{ucfirst: abc}}" → "Abc" [4]

• URL encoding:

"{{urlencode: AbC
dEf ghi}}"

renders as

"AbC%0AdEf+ghi"

{{anchorencode: AbC dEf ghi}}

renders as

AbC_dEf_ghi

• Help:Parser functions in templates
• Parser extension tags
• Parser function hooks – an (incomplete) list of parser functions added by core and extensions.
• Manual:Newlines and spaces
• Manual:Converting between ParserFunctions syntax and TeX syntax
• คู่มือ:คําพิเศษ – in particular for number formatting and padding
• Manual:Template limits#Expensive parser function calls

• Parser functions for Wikibase (the extensions that enables Wikidata): How to use data on Wikimedia projects#Parser function

• Extension help/th
• Magic words/th