Struct Entry 

pub struct Entry { /* private fields */ }

A single time-tracked entry in a TaskPaper doing file.

Each entry has a start date, a tag-free title, tags, an optional note, the section it belongs to, and a unique 32-character hex ID.

Implementations

impl Entry

pub fn new( date: DateTime<Local>, title: impl Into<String>, tags: Tags, note: Note, section: impl Into<String>, id: Option<impl Into<String>>, ) -> Self

Create a new entry with the given fields.

If id is None, a deterministic ID is generated from the entry content.

pub fn date(&self) -> DateTime<Local>

Return the start date.

pub fn done_date(&self) -> Option<DateTime<Local>>

Return the parsed @done tag timestamp, if present and valid.

pub fn duration(&self) -> Option<Duration>

Return elapsed time since the start date.

For finished entries this returns None — use interval instead.

pub fn end_date(&self) -> Option<DateTime<Local>>

Return the end date: the @done tag timestamp if present, otherwise None.

pub fn finished(&self) -> bool

Return whether the entry has a @done tag.

pub fn full_title(&self) -> String

Return the title with inline tags, matching the original entry format.

pub fn id(&self) -> &str

Return the 32-character hex ID.

pub fn interval(&self) -> Option<Duration>

Return the time between the start date and the @done date.

Returns None if the entry is not finished or the done date cannot be parsed.

pub fn note(&self) -> &Note

Return the note.

pub fn note_mut(&mut self) -> &mut Note

Return a mutable reference to the note.

pub fn overlapping_time(&self, other: &Entry) -> bool

Check whether this entry’s time range overlaps with another entry’s.

Uses each entry’s start date and end date (from @done tag). If either entry lacks an end date, the current time is used.

pub fn section(&self) -> &str

Return the section name.

pub fn set_date(&mut self, date: DateTime<Local>)

Set the start date.

pub fn set_title(&mut self, title: impl Into<String>)

Set the title.

pub fn should_finish(&self, never_finish: &[String]) -> bool

Check whether the entry should receive a @done tag.

Returns false if any pattern in never_finish matches this entry’s tags (patterns starting with @) or section name.

pub fn should_time(&self, never_time: &[String]) -> bool

Check whether the entry should receive a date on the @done tag.

Returns false if any pattern in never_time matches this entry’s tags (patterns starting with @) or section name.

pub fn tags(&self) -> &Tags

Return the tags.

pub fn tags_mut(&mut self) -> &mut Tags

Return a mutable reference to the tags.

pub fn title(&self) -> &str

Return the tag-free title.

pub fn unfinished(&self) -> bool

Return whether the entry does not have a @done tag.

Trait Implementations

impl Clone for Entry

fn clone(&self) -> Entry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Entry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Entry

fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult

Format as a full title line: title @tag1 @tag2(val) <id>