add new api: new_dated