Add Tag::date_raw to get date string before Timestamp conversion

Cargo.toml

@@ -26,3 +26,4 @@ readme-rustdocifier = "0.1.1"
 [features]
 default = ['from']
 from = []
+raw-date = []

src/components/flac_tag.rs

@@ -17,7 +17,7 @@ impl<'a> From<AnyTag<'a>> for FlacTag {
             t.set_artist(&v)
         }
         if let Some(v) = inp.date {
-            t.set_date(v)
+            t.set_date(TimestampTag::Id3(v))
         }
         if let Some(v) = inp.year {
             t.set_year(v)
@@ -117,8 +117,17 @@ impl AudioTagEdit for FlacTag {
             None
         }
     }
-    fn set_date(&mut self, date: Timestamp) {
-        self.set_first("DATE", &date.to_string());
+    #[cfg(feature = "raw-date")]
+    fn date_raw(&self) -> Option<TimestampTag> {
+        self.get_first("DATE")
+            .map(|e| TimestampTag::Unknown(e.to_string()))
+    }
+    fn set_date(&mut self, date: TimestampTag) {
+        match date {
+            TimestampTag::Id3(date_fmt) => self.set_first("DATE", &date_fmt.to_string()),
+            #[cfg(feature = "raw-date")]
+            TimestampTag::Unknown(date_str) => self.set_first("DATE", &date_str.to_string()),
+        }
     }
     fn remove_date(&mut self) {
         self.remove("DATE");

src/components/id3_tag.rs

@@ -109,8 +109,23 @@ impl AudioTagEdit for Id3v2Tag {
     fn date(&self) -> Option<Timestamp> {
         self.inner.date_recorded()
     }
-    fn set_date(&mut self, timestamp: Timestamp) {
-        self.inner.set_date_recorded(timestamp)
+    #[cfg(feature = "raw-date")]
+    fn date_raw(&self) -> Option<TimestampTag> {
+        self.inner.get("TDRC").and_then(|frame| {
+            frame
+                .content()
+                .text()
+                .map(|e| TimestampTag::Unknown(e.to_string()))
+        })
+    }
+    fn set_date(&mut self, date: TimestampTag) {
+        match date {
+            TimestampTag::Id3(date_fmt) => self.inner.set_date_recorded(date_fmt),
+            #[cfg(feature = "raw-date")]
+            TimestampTag::Unknown(date_str) => {
+                self.inner.add_frame(Frame::text("TDRC", date_str));
+            }
+        }
     }
     fn remove_date(&mut self) {
         self.inner.remove_date_recorded()

src/components/mp4_tag.rs

@@ -148,8 +148,18 @@ impl AudioTagEdit for Mp4Tag {
             None
         }
     }
-    fn set_date(&mut self, date: Timestamp) {
-        self.inner.set_year(date.to_string())
+    #[cfg(feature = "raw-date")]
+    fn date_raw(&self) -> Option<TimestampTag> {
+        self.inner
+            .year()
+            .map(|e| TimestampTag::Unknown(e.to_string()))
+    }
+    fn set_date(&mut self, date: TimestampTag) {
+        match date {
+            TimestampTag::Id3(date_fmt) => self.inner.set_year(date_fmt.to_string()),
+            #[cfg(feature = "raw-date")]
+            TimestampTag::Unknown(date_str) => self.inner.set_year(date_str.to_string()),
+        }
     }
     fn remove_date(&mut self) {
         self.inner.remove_year()

src/traits.rs

@@ -33,7 +33,9 @@ pub trait AudioTagEdit: AudioTagConfig {
     }
 
     fn date(&self) -> Option<Timestamp>;
-    fn set_date(&mut self, date: Timestamp);
+    #[cfg(feature = "raw-date")]
+    fn date_raw(&self) -> Option<TimestampTag>;
+    fn set_date(&mut self, date: TimestampTag);
     fn remove_date(&mut self);
 
     fn year(&self) -> Option<i32>;

src/types.rs

@@ -9,6 +9,21 @@ pub enum MimeType {
     Gif,
 }
 
+/// The types of date for the timestamp.
+/// Most of the time you will want to use `TimestampTag::Id3` as it is using the
+/// standard specifications. However when you are working with audio with
+/// unknown date format or non-ISO then you can use `TimestampTag::Unknown` as
+/// an escape hatch to get the original text and parse to your own format
+/// if needed.
+///
+/// - To use TimestampTag you need to enable the `raw-date` feature
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum TimestampTag {
+    Id3(id3::Timestamp),
+    #[cfg(feature = "raw-date")]
+    Unknown(String),
+}
+
 impl TryFrom<&str> for MimeType {
     type Error = crate::Error;
     fn try_from(inp: &str) -> crate::Result<Self> {

tests/io.rs

@@ -1,4 +1,4 @@
-use audiotags::{MimeType, Picture, Tag};
+use audiotags::{MimeType, Picture, Tag, TimestampTag};
 use id3::Timestamp;
 use std::ffi::OsString;
 use std::fs;
@@ -30,7 +30,7 @@ macro_rules! test_file {
             assert!(tags.artist().is_none());
             tags.remove_artist();
 
-            tags.set_date(Timestamp::from_str("2020-05-22").unwrap());
+            tags.set_date(TimestampTag::Id3(Timestamp::from_str("2020-05-22").unwrap()));
             assert_eq!(
                 tags.date(),
                 Some(Timestamp::from_str("2020-05-22").unwrap())