...

Discussion thread: here
JIRA:

Motivation

1. KAFKA-7277:
   

   Right now Streams API universally represents time as ms-since-unix-epoch.
   There's nothing wrong, per se, with this, but Duration is more ergonomic for an API.
   What we don't want is to present a heterogeneous API, so we need to make sure the whole Streams API is in terms of Duration.
   
   

2. KAFKA-7477:
   Improve of semantics of KafkaStreams#close(Duration)

Public Interfaces

We need to add following method to public API.

...

1. In this scope keep existing methods as is.
   Try to reduce the visibility of methods in next tickets.
2. Introduce finer methods with Instant and Duration

Changes in KafkaStream#close semantics:

1. reject negative numbers
2. make 0 just signal and return immediately (after checking the state once)

Compatibility, Deprecation, and Migration Plan

...