TextFormatter (filter-service-metrics 1.13 1.13 API)

java.lang.Object
- com.linecorp.armeria.common.util.TextFormatter

```
public final class TextFormatter
extends Object
```
A utility class to format things as a String with ease.

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`appendElapsed(StringBuilder buf, long elapsedNanos)` Appends the human-readable representation of the duration given as `elapsed` to the specified `StringBuilder`.
`static void`	`appendElapsed(StringBuilder buf, long startTimeNanos, long endTimeNanos)` Appends the human-readable representation of the duration between the specified `startTimeNanos` and `endTimeNanos` to the specified `StringBuilder`.
`static void`	`appendElapsedAndSize(StringBuilder buf, long startTimeNanos, long endTimeNanos, long size)` A shortcut method that calls `appendElapsed(StringBuilder, long, long)` and `appendSize(StringBuilder, long)`, concatenated by `", "`.
`static void`	`appendEpoch(StringBuilder buf, long timeMillis)` Deprecated. Use `appendEpochMillis(StringBuilder, long)`.
`static void`	`appendEpochMicros(StringBuilder buf, long timeMicros)` Formats the given epoch time in microseconds to typical human-readable format "yyyy-MM-dd'T'HH_mm:ss.SSSX" and appends it to the specified `StringBuilder`.
`static void`	`appendEpochMillis(StringBuilder buf, long timeMillis)` Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH_mm:ss.SSSX" and appends it to the specified `StringBuilder`.
`static void`	`appendSize(StringBuilder buf, long size)` Appends the human-readable representation of the specified byte-unit `size` to the specified `StringBuffer`.
`static StringBuilder`	`elapsed(long elapsedNanos)` Creates a new `StringBuilder` whose content is the human-readable representation of the duration given as `elapsed`.
`static StringBuilder`	`elapsed(long startTimeNanos, long endTimeNanos)` Creates a new `StringBuilder` whose content is the human-readable representation of the duration between the specified `startTimeNanos` and `endTimeNanos`.
`static StringBuilder`	`elapsedAndSize(long startTimeNanos, long endTimeNanos, long size)` Similar to `appendElapsedAndSize(StringBuilder, long, long, long)` except that this method creates a new `StringBuilder`.
`static StringBuilder`	`epoch(long timeMillis)` Deprecated. Use `epochMillis(long)`.
`static StringBuilder`	`epochMicros(long timeMicros)` Formats the given epoch time in microseconds to typical human-readable format "yyyy-MM-dd'T'HH:mm:ss.SSSX".
`static StringBuilder`	`epochMillis(long timeMillis)` Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH:mm:ss.SSSX".
`static StringBuilder`	`size(long size)` Creates a new `StringBuilder` whose content is the human-readable representation of the byte-unit `size`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - appendSize
```
public static void appendSize(StringBuilder buf,
                              long size)
```
    Appends the human-readable representation of the specified byte-unit size to the specified StringBuffer.
  - appendElapsed
```
public static void appendElapsed(StringBuilder buf,
                                 long elapsedNanos)
```
    Appends the human-readable representation of the duration given as elapsed to the specified StringBuilder.
  - appendElapsed
```
public static void appendElapsed(StringBuilder buf,
                                 long startTimeNanos,
                                 long endTimeNanos)
```
    Appends the human-readable representation of the duration between the specified startTimeNanos and endTimeNanos to the specified StringBuilder.
  - appendElapsedAndSize
```
public static void appendElapsedAndSize(StringBuilder buf,
                                        long startTimeNanos,
                                        long endTimeNanos,
                                        long size)
```
    A shortcut method that calls appendElapsed(StringBuilder, long, long) and appendSize(StringBuilder, long), concatenated by ", ".
  - elapsed
```
public static StringBuilder elapsed(long elapsedNanos)
```
    Creates a new StringBuilder whose content is the human-readable representation of the duration given as elapsed.
  - elapsed
```
public static StringBuilder elapsed(long startTimeNanos,
                                    long endTimeNanos)
```
    Creates a new StringBuilder whose content is the human-readable representation of the duration between the specified startTimeNanos and endTimeNanos.
  - size
```
public static StringBuilder size(long size)
```
    Creates a new StringBuilder whose content is the human-readable representation of the byte-unit size.
  - elapsedAndSize
```
public static StringBuilder elapsedAndSize(long startTimeNanos,
                                           long endTimeNanos,
                                           long size)
```
    Similar to appendElapsedAndSize(StringBuilder, long, long, long) except that this method creates a new StringBuilder.
  - epoch
```
@Deprecated
public static StringBuilder epoch(long timeMillis)
```
    Deprecated. Use epochMillis(long).
    
    Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH:mm:ss.SSSX".
    
    Parameters:
    
    timeMillis - epoch time in milliseconds
    
    Returns:
    
    the human readable string representation of the given epoch time
  - appendEpoch
```
@Deprecated
public static void appendEpoch(StringBuilder buf,
                                           long timeMillis)
```
    Deprecated. Use appendEpochMillis(StringBuilder, long).
    
    Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH_mm:ss.SSSX" and appends it to the specified StringBuilder.
  - epochMillis
```
public static StringBuilder epochMillis(long timeMillis)
```
    Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH:mm:ss.SSSX".
    
    Parameters:
    
    timeMillis - epoch time in milliseconds
    
    Returns:
    
    the human readable string representation of the given epoch time
  - appendEpochMillis
```
public static void appendEpochMillis(StringBuilder buf,
                                     long timeMillis)
```
    Formats the given epoch time in milliseconds to typical human-readable format "yyyy-MM-dd'T'HH_mm:ss.SSSX" and appends it to the specified StringBuilder.
  - epochMicros
```
public static StringBuilder epochMicros(long timeMicros)
```
    Formats the given epoch time in microseconds to typical human-readable format "yyyy-MM-dd'T'HH:mm:ss.SSSX".
    
    Parameters:
    
    timeMicros - epoch time in microseconds
    
    Returns:
    
    the human readable string representation of the given epoch time
  - appendEpochMicros
```
public static void appendEpochMicros(StringBuilder buf,
                                     long timeMicros)
```
    Formats the given epoch time in microseconds to typical human-readable format "yyyy-MM-dd'T'HH_mm:ss.SSSX" and appends it to the specified StringBuilder.

Class TextFormatter

Method Summary

Methods inherited from class java.lang.Object

Method Detail

appendSize

appendElapsed

appendElapsed

appendElapsedAndSize

elapsed

elapsed

size

elapsedAndSize

epoch

appendEpoch

epochMillis

appendEpochMillis

epochMicros

appendEpochMicros