Quelltext der Seite Vorlage:Maß/Doku

<noinclude>{{Heim-gast Vorlage}}</noinclude><noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{Tausendfach verwendet}}
Diese [[Vorlage:Maß]] (bzw. [[Vorlage:Mass]]) dient zum Umrechnen und Formatieren von ''berechneten'' Zahlen mitsamt Einheitenzeichen.

Da ihre Ausgabe keinen semantischen Mehrwert generiert, ist es sinnfrei, die Vorlage nur zur Zahlenformatierung zu nutzen. Sie sollte daher bevorzugt innerhalb von Vorlagen, Infoboxen und dergleichen angewendet werden.

Sonderfälle: Bei den Einheiten ''km'' und ''km²'' wird automatisch ''m'' bzw. ''ha'' verwendet, falls die Eingabe kleiner als 1,0 ist und keine Parameter zur Umrechnung übergeben werden.

Bei Fehlangaben: Nichtnumerische Parameter werden unverändert ausgegeben und [[Spezial:Verweisliste/Vorlage:Maß/Wartung/Maßzahl nicht numerisch|erzeugen einen Wartungseintrag „Maßzahl nicht numerisch“]].

== Kopiervorlagen ==
<syntaxhighlight lang="wikitext" copy>
{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=|eps=|kl=1}}
{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=|eps=}}
{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=}}
{{Maß| | | | | |round=|eps=}}
{{Maß| | |6=|7=|8=|round=}}
</syntaxhighlight>

== Parameter ==
'''Zwei Pflichteingaben:'''
;<code>1</code>: Die Maßzahl, der Zahlenwert des Maßes.
;<code>2</code>: Die Maßeinheit. Ausgefallene Einheiten können verlinkt werden.

'''Für eine Umrechnung in eine kleinere Einheit:'''
;<code>3</code>: Ein Schwellwert zur kleineren Einheit
;<code>4</code>: Eine Einheit kleiner als bei Parameter '''<code>2</code>'''
;<code>5</code>: Der Umrechnungsfaktor zur kleineren Einheit, also <math>\tfrac\text{Parameter 2}\text{Parameter 4}</math>.

'''Für eine Umrechnung in eine größere Einheit:'''
;<code>6</code>: Ein Schwellwert zur größeren Einheit
;<code>7</code>: eine größere Einheit als Parameter '''<code>2</code>'''
;<code>8</code>: Der (inverse) Umrechnungsfaktor zur größeren Einheit, also <math>\tfrac\text{Parameter 7}\text{Parameter 2}</math>.
{{!!!| ''' Bei ausschließlicher Umrechnung in größere Einheiten, wird dringend empfohlen, die jeweiligen Standardparameter explizit zuzuweisen; zum&nbsp;Beispiel: <syntaxhighlight inline lang="mediawiki" copy>|6=…|7=…|8=…</syntaxhighlight> ''' }}

'''Weitere Parameter:'''
;<code>round</code>: Anzahl der Nachkommastellen. ''Bei einer etwaigen Umrechnung in eine größere Einheit ist diese Angabe dringend erforderlich, wenn die Division durch Parameter'' <code>8</code> ''zu viele Dezimalstellen erzeugt (z. B. periodische Dezimalzahl)!''
;<code>eps</code>: Mithilfe dieses optionalen Parameters kann ein Wert im Format <samp>Schätzwert ± Messunsicherheit</samp> ausgegeben werden. Die Einheiten von Messunsicherheit und Schätzwert sind identisch. Bei Angabe eines Schwellwerts wird entsprechend umgerechnet. Der Schätzwert wird mit Parameter '''<code>1</code>''' übergeben.
;<code>kl</code>: Ein logischer Parameter; ist er nicht leer und auch ein Wert für die Messunsicherheit (eps) angegeben, so wird das Ergebnis mit einer Klammer versehen: <samp>(Schätzwert ± Messunsicherheit)</samp>

{{TemplateData|JSON={
    "description": "Umrechnen und Formatieren von ''berechneten'' Zahlen mitsamt Einheitenzeichen.",
    "params": {
      "1": {
        "label": "Maßzahl",
        "description": "Die Maßzahl, der Zahlenwert des Maßes.",
        "example": "1234.56789",
        "required": true,
        "type": "number"
      },
      "2": {
        "label": "Maßeinheit",
        "description": "Einheit, in der gemessen wird",
        "example": "m",
        "required": true,
        "type": "line"
      },
      "3": {
        "label": "Schwellwert (kl. Einheit)",
        "description": "Schwellwert für die Umrechnung in eine kleinere Einheit.",
        "example": "1",
        "required": false,
        "type": "number"
      },
      "4": {
        "label": "Die kleinere Einheit",
        "description": "Eine kleinere Einheit, kleiner als bei Parameter 2.",
        "example": "cm",
        "required": false,
        "type": "line"
      },
      "5": {
        "label": "Umrechnungsfaktor (kl. Einheit)",
        "description": "Der Umrechnungsfaktor der kleineren Einheit: Parameter 2 ÷ Parameter 4",
        "example": "100",
        "required": false,
        "type": "number"
      },
      "6": {
        "label": "Schwellwert (gr. Einheit)",
        "description": "Schwellwert für die Umrechnung in eine größere Einheit.",
        "example": "1000",
        "required": false,
        "type": "number"
      },
      "7": {
        "label": "Die größere Einheit",
        "description": "Eine größere Einheit, größer als bei Parameter 2. (Umrechnung in größere Einheit).",
        "example": "km",
        "required": false,
        "type": "line"
      },
      "8": {
        "label": "Umrechnungsfaktor (gr. Einheit)",
        "description": "Der Umrechnungsfaktor der größeren Einheit: Parameter 2 ÷ Parameter 4",
        "example": "1000",
        "required": false,
        "type": "number"
      },
      "round": {
        "label": "Nachkommastellen",
        "description": "Runden auf diese Anzahl Nachkommastellen.",
        "example": "3",
        "required": false,
        "type": "number"
      },
      "eps": {
        "label": "Messunsicherheit",
        "description": "Fügt dem Resultat einen Wert für Messunsicherheit hinzu: Messwert ± Messunsicherheit.",
        "example": "5",
        "required": false,
        "type": "number"
      },
      "kl": {
        "label": "Klammern",
        "description": "Wenn hier und für die Messunsicherheit (eps) ein Wert angegeben ist, wird das Resultat in Klammern gesetzt.",
        "example": "1",
        "required": false,
        "type": "line"
      }
    }
  }
|TOC=1|sort=Mass0}}

== Beispiele ==
{{Info |1=Es bietet sich an, ggf. einzelne Leerzeichen zur Gruppierung der Parameter zu nutzen; ähnlich der Zifferngruppierung.}}

'''Beispiel für Schwellwert:'''
:<syntaxhighlight inline lang="mediawiki">{{Maß|0.578|km²|1|ha|100}}</syntaxhighlight> wird zu {{Maß|0.578|km²|1|ha|100}}, weil 0,578&nbsp;km² kleiner als 1&nbsp;km² sind. Ein Quadratkilometer hat 100 Hektar.

'''Beispiel mit Rundung:'''
:<syntaxhighlight inline lang="mediawiki">{{Maß|19.12|km |1|m|1000 |round=1}}</syntaxhighlight> wird zu {{Maß|19.12|km|1|m|1000|round=1}}

'''Beispiel mit Messunsicherheit:'''
:<syntaxhighlight inline lang="mediawiki">{{Maß|1.578|kg |1|g|1000 |eps=0.02}}</syntaxhighlight> ergibt {{Maß|1.578|kg|1|g|1000|eps=0.02}}

'''Beispiel einer Schätzung; mit Messunsicherheit und Klammern:'''
:<syntaxhighlight inline lang="mediawiki">{{Maß |1.578|kg |1|g|1000 |eps=0.02|kl=ja}}</syntaxhighlight> ergibt {{Maß|1.578|kg|1|g|1000|eps=0.02|kl=ja}}

'''Weitere Beispiele:'''<br>
{| class="wikitable hintergrundfarbe-basis"
|-
! Quelltext-Eingabe !! Resultat
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|3000 m|m}}</syntaxhighlight> ||style="text-align:right"| {{Maß|3000 m|m}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|3000|m}}</syntaxhighlight> ||style="text-align:right"| {{Maß|3000|m}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.99|cm |1|mm|10 |10|dm|1 |round=3}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.99|cm |1|mm|10 |10|dm|1 |round=3}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|1.11|cm |1|mm|10 |10|dm|1 |round=3}}</syntaxhighlight> ||style="text-align:right"| {{Maß|1.11|cm |1|mm|10 |10|dm|1 |round=3}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.99|km |1|m|1000 |round=1}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.99|km|1|m|1000|round=1}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.99756|km |1|m|1000 |round=1}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.99756|km|1|m|1000|round=1}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|1.993|km |1|m|1000 |round=1}}</syntaxhighlight> ||style="text-align:right"| {{Maß|1.993|km|1|m|1000|round=1}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|1.993|km |1|m|1000 |round=2}}</syntaxhighlight> ||style="text-align:right"| {{Maß|1.993|km|1|m|1000|round=2}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.99|xyz}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.99|xyz}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.99|km²}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.99|km²}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|7.99|km²}}</syntaxhighlight> ||style="text-align:right"| {{Maß|7.99|km²}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|1.234567|km |1|m|1000 |round=0}}</syntaxhighlight> ||style="text-align:right"| {{Maß|1.234567|km|1|m|1000|round=0}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.234567|km |1|m|1000 |round=0}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.234567|km|1|m|1000|round=0}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|1234.5678901234|m |1|cm|100 |1000|km|1000 |round=3}}</syntaxhighlight> ||style="text-align:right"| {{Maß |1234.5678901234|m |1|cm|100 |1000|km|1000 |round=3}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|0.578|kg |1|g|1000 |eps=0.02}}</syntaxhighlight> ||style="text-align:right"| {{Maß|0.578|kg|1|g|1000|eps=0.02}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|578|kg|eps=2}}</syntaxhighlight> ||style="text-align:right"| {{Maß|578|kg|eps=2}}
|-
| <syntaxhighlight inline lang="mediawiki">{{Maß|150682490000|m³ |1 |6=100000000 |7=km³ |8=1000000000}}</syntaxhighlight> ||style="text-align:right"| {{Maß|150682490000|m³|1|6=100000000<!--ab 0.1 auf km³-->|7=km³|8=1000000000}}
|}

{{Lua-Vorlage|Measure #Masz}}

<includeonly>
{{SORTIERUNG:Mass1}}
[[Kategorie:Vorlage:Zahlenformatierung]]
</includeonly>