.. _timestampconverter:

==================
TimestampConverter
==================

Description
-----------
Convert timestamps between different formats such as Unix epoch, strings, and Connect Date/Timestamp types. Applies to individual fields or to the entire value.

Use the concrete transformation type designed for the record key (``org.apache.kafka.connect.transforms.TimestampConverter$Key``) or value (``org.apache.kafka.connect.transforms.TimestampConverter$Value``).


Properties
----------

.. list-table::
   :header-rows: 1
   :widths: 15 30 10 10 10 10

   *  - Name
      - Description
      - Type
      - Default
      - Valid Values
      - Importance
   *  - ``target.type``
      - The desired timestamp representation: string, unix, Date, Time, or Timestamp.
      - string
      -
      -
      - high
   *  - ``field``
      - The field containing the timestamp, or empty if the entire value is a timestamp.
      - string
      - `""`
      -
      - high
   *  - ``format``
      - A SimpleDateFormat-compatible format for the timestamp. Used to generate the output when type=string or used to parse the input if the input is a string.
      - string
      - `""`
      -
      - medium