| 37 | * @author Meno Hochschild |
| 38 | */ |
| 39 | public interface IsoUnit |
| 40 | extends ChronoUnit { |
| 41 | |
| 42 | //~ Methoden ---------------------------------------------------------- |
| 43 | |
| 44 | /** |
| 45 | * <p>Gets the format symbol which is used to display this time unit |
| 46 | * in canonical representations of timespans. </p> |
| 47 | * |
| 48 | * <p>Canonical timespan formats follow ISO-8601. For example, the day |
| 49 | * unit is represented by the symbol D. Note that the letters P and T |
| 50 | * must not be used because these special characters are for structuring, |
| 51 | * the display. In ISO-8601 following symbols are defined: </p> |
| 52 | * |
| 53 | * <ul> |
| 54 | * <li>Y - year</li> |
| 55 | * <li>M - month or minute</li> |
| 56 | * <li>W - week</li> |
| 57 | * <li>D - day</li> |
| 58 | * <li>H - hour</li> |
| 59 | * <li>S - second</li> |
| 60 | * <li>P - qualifies a timespan (period)</li> |
| 61 | * <li>T - separates date and time part</li> |
| 62 | * </ul> |
| 63 | * |
| 64 | * <p>If this method yields as special case a digit 1-9 then Time4J expects |
| 65 | * a fractional display of preceding second unit S that is nanoseconds, |
| 66 | * microseconds and milliseconds. Time4J will use the comma as decimal |
| 67 | * separation char in the canonical display as recommended by ISO-8601 |
| 68 | * unless the system property "net.time4j.format.iso.decimal.dot" |
| 69 | * is set to {@code true} (which causes the usage of a dot). </p> |
| 70 | * |
| 71 | * @return char (ASCII-NULL if undefined) |
| 72 | * @see Duration#toString() |
| 73 | */ |
| 74 | /*[deutsch] |
| 75 | * <p>Liefert das Formatsymbol, mit dem diese Instanz in kanonischen |
| 76 | * Darstellungen von Zeitspannen repräsentiert wird. </p> |
| 77 | * |
| 78 | * <p>Kanonische Zeitspannenformate folgen dem ISO-Standard. Zum Beispiel |
| 79 | * wird der Tag durch den Buchstaben D repräsentiert. Zu beachten ist, |
| 80 | * daß die Buchstaben P und T hier nicht verwendet werden dürfen, |
| 81 | * da sie die Darstellung strukturieren. Im ISO-8601-Format gilt: </p> |
| 82 | * |
| 83 | * <ul> |
| 84 | * <li>Y - Jahr (engl.: <i>year</i>)</li> |
| 85 | * <li>M - Monat oder Minute (engl.: <i>month or minute</i>)</li> |
| 86 | * <li>W - Woche (engl.: <i>week</i>)</li> |
| 87 | * <li>D - Tag (engl.: <i>day</i>)</li> |
| 88 | * <li>H - Stunde (engl.: <i>hour</i>)</li> |
| 89 | * <li>S - Sekunde (engl.: <i>second</i>)</li> |
| 90 | * <li>P - Qualifiziert eine Zeitspanne (englisch: <i>period</i>)</li> |
| 91 | * <li>T - Trennt Datums- und Uhrzeitanteil</li> |
| 92 | * </ul> |
| 93 | * |
| 94 | * <p>Liefert die Methode als Sonderfall eine Ziffer 1-9, dann erwartet |
| 95 | * Time4J eine fraktionale Anzeige der vorangehenden Sekundenzeiteinheit S, |
| 96 | * also Nanos, Mikros und Millisekunden. Als Dezimaltrennzeichen wird in |
no outgoing calls
no test coverage detected