Class TimeColumn

java.lang.Object

io.github.kelsoncm.fwf.columns.AbstractColumn

io.github.kelsoncm.fwf.columns.DateTimeColumn

io.github.kelsoncm.fwf.columns.TimeColumn

public class TimeColumn
extends DateTimeColumn

Time column supporting custom formatting and zero-padding for null values.

Field Summary

Fields inherited from class DateTimeColumn

format, formatter, javaPattern, requiredFormatNumElements

Fields inherited from class AbstractColumn

description, name, size, start

Constructor Summary

Constructors

Constructor	Description
TimeColumn(String name)	Constructs a new TimeColumn with a name, defaulting to format "%H%M".
TimeColumn(String name, String format)	Constructs a new TimeColumn with a name and format.
TimeColumn(String name, String format, String description)	Constructs a new TimeColumn with a name, format, and description.

Method Summary

Modifier and Type	Method	Description
String	toStr(Object value)	Formats a LocalTime or null into a fixed-width string of exact column size.
Object	toValue(String slice)	Converts a raw fixed-width time string slice into a LocalTime value.

Methods inherited from class DateTimeColumn

calculateSize, convertPythonFormatToJavaPattern, getFormat

Methods inherited from class AbstractColumn

getDescription, getEnd, getName, getSize, getStart, setStart, validateToStrSize

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TimeColumn

public TimeColumn(String name,
 String format,
 String description)

Constructs a new TimeColumn with a name, format, and description.

Parameters:

name - the column name

format - Python-style time format string

description - human-readable description

TimeColumn

public TimeColumn(String name,
 String format)

Constructs a new TimeColumn with a name and format.

Parameters:

name - the column name

format - Python-style time format string

TimeColumn

public TimeColumn(String name)

Constructs a new TimeColumn with a name, defaulting to format "%H%M".

Parameters:

name - the column name

Method Details

toValue

public Object toValue(String slice)

Converts a raw fixed-width time string slice into a LocalTime value.

Overrides:

toValue in class DateTimeColumn

Parameters:

slice - raw fixed-width substring

Returns:

parsed LocalTime, or null if slice consists entirely of zeros

Throws:

IllegalArgumentException - if slice is null or has an invalid format

toStr

public String toStr(Object value)

Formats a LocalTime or null into a fixed-width string of exact column size.

Overrides:

toStr in class DateTimeColumn

Parameters:

value - LocalTime or null to format

Returns:

formatted time string or zero-filled string of size AbstractColumn.getSize()

Throws:

IllegalArgumentException - if value is not a LocalTime