System.DateAcquired

The acquisition date of the file or media. This property is related to a particular user or group of users. For example, this data is used as the main sorting axis for the virtual folder New Music, which enables people to browse the latest additions to their collection.

propertyDescription
   name = System.DateAcquired
   shellPKey = PKEY_DateAcquired
   formatID = 2CBAA8F5-D81F-47CA-B17A-F8D822300131
   propID = 100
   searchInfo
      inInvertedIndex = true
      isColumn = true
      isColumnSparse = true
      columnIndexType = OnDisk
      maxSize = 128
      mnemonics = acquired
   labelInfo
      label = Date acquired
      sortDescription
      invitationText = Specify date and time acquired
      hideLabel = false
   typeInfo
      type = DateTime
      groupingRange = Discrete
      isInnate = false
      multipleValues = false
      isGroup = false
      aggregationType = Default
      isTreeProperty = false
      isViewable = true
      isQueryable = true
      includeInFullTextQuery = false
      conditionType = String
      defaultOperation = Equal
   aliasInfo
      sortByAlias = None
      additionalSortByAliases = None
   displayInfo
      defaultColumnWidth = 20
      displayType
      alignment = Left
      relativeDescriptionType = General
      defaultSortDirection = Ascending
      stringFormat
         formatAs = General
      booleanFormat
         formatAs = YesNo
      numberFormat
         formatAs = General
         formatDurationAs = hh:mm:ss
      dateTimeFormat
         formatAs = General
         formatTimeAs = ShortTime
         formatDateAs = ShortDate
      enumeratedList
         defaultText
         useValueForDefault = False
         enum
            value
            text
         enumRange
            minValue
            setValue
            text
      drawControl
         control = Default
      editControl
         control = Default
      filterControl
         control = Default
      queryControl
         control = Default

Remarks

PKEY values are defined in Propkey.h.

DateAcquired is stored as a value in the main stream of the file, but it may not always be present. In those instances, the acquisition date can be approximated based on other known dates for the content. The metadata handler should use a set of rules to determine the date to return. The following example demonstrates this for music files.

  • For purchased music, the file's creation time should be used if no acquired date is present. However, the download provider should set the DateAcquired property in the file.
  • For music files that the user or group "ripped" (copying music or video from a CD or DVD to a hard disk), the acquisition date should be the date that action took place. For instance, the WM/EncodingTime attribute.
  • For music copied from another location, the file's creation time should be used as the acquisition date.

Examples of System.DateAcquired are the date and time when pictures are acquired from a camera or when music is purchased online. This is not the same as System.DateImported.

Related topics

propertyDescription
searchInfo
labelInfo
typeInfo
displayInfo
stringFormat
booleanFormat
numberFormat
dateTimeFormat
enumeratedList
drawControl
editControl
filterControl
queryControl

 

 

Show: