PrintSystemJobInfo.UntilTimeOfDay 屬性

定義

命名空間:

System.Printing

組件:

System.Printing.dll

取得一天中印表機開始列印工作的最後時間，以午夜 Coordinated Universal Time (UTC，亦稱為格林威治標準時間 (Greenwich Mean Time，GMT)) 之後經過的分鐘數表示。

public:
 property int UntilTimeOfDay { int get(); };

public int UntilTimeOfDay { get; }

member this.UntilTimeOfDay : int

Public ReadOnly Property UntilTimeOfDay As Integer

屬性值

Int32

Int32，指定工作可以列印的最後時間，以午夜 (UTC) 之後經過的分鐘數表示。 最大值為 1439。

範例

下列範例示範如何在診斷有問題的列印作業過程中使用這個屬性。

static Boolean ReportAvailabilityAtThisTime (PrintSystemJobInfo^ theJob) 
{
   Boolean available = true;
   if (theJob->StartTimeOfDay != theJob->UntilTimeOfDay)
   {
      DateTime utcNow = DateTime::UtcNow;
      Int32 utcNowAsMinutesAfterMidnight = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes;

      // If "now" is not within the range of available times . . .
      if (!((theJob->StartTimeOfDay < utcNowAsMinutesAfterMidnight) && (utcNowAsMinutesAfterMidnight < theJob->UntilTimeOfDay)))
      {
         available = false;
      }
   }
   return available;
}

private static Boolean ReportAvailabilityAtThisTime(PrintSystemJobInfo theJob)
{
    Boolean available = true;
    if (theJob.StartTimeOfDay != theJob.UntilTimeOfDay) // If the job cannot be printed at all times of day
    {
        DateTime utcNow = DateTime.UtcNow;
        Int32 utcNowAsMinutesAfterMidnight = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes;

        // If "now" is not within the range of available times . . .
        if (!((theJob.StartTimeOfDay < utcNowAsMinutesAfterMidnight) 
           && 
           (utcNowAsMinutesAfterMidnight < theJob.UntilTimeOfDay)))
        {
            available = false;
        }
    }
    return available;
}//end ReportAvailabilityAtThisTime

Private Shared Function ReportAvailabilityAtThisTime(ByVal theJob As PrintSystemJobInfo) As Boolean
    Dim available As Boolean = True
    If theJob.StartTimeOfDay <> theJob.UntilTimeOfDay Then ' If the job cannot be printed at all times of day
        Dim utcNow As Date = Date.UtcNow
        Dim utcNowAsMinutesAfterMidnight As Int32 = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes

        ' If "now" is not within the range of available times . . .
        If Not((theJob.StartTimeOfDay < utcNowAsMinutesAfterMidnight) AndAlso (utcNowAsMinutesAfterMidnight < theJob.UntilTimeOfDay)) Then
            available = False
        End If
    End If
    Return available
End Function 'end ReportAvailabilityAtThisTime

備註

當作業進入佇列時，這個值會從PrintQueue.UntilTimeOfDay裝載PrintQueue的 屬性傳播至每個PrintSystemJobInfo物件。 如果 PrintQueue.UntilTimeOfDay 已變更，則任何 PrintSystemJobInfo.UntilTimeOfDay 晚於 PrintQueue.UntilTimeOfDay 的值會變更為的值 PrintQueue.UntilTimeOfDay。

將作業新增至佇列之後，您可以透過 Microsoft Windows 使用者介面 (UI) 提供新的 UntilTimeOfDay 值，前提是它不晚於 PrintQueue.UntilTimeOfDay。

如果您不在 UTC 時區，您必須新增或減去 60 的倍數，以取得時區的正確時間。 例如，如果您位於 北美洲 的太平洋時區，且日光節約時間並未生效，則您的當地時間比 UTC 早 8 小時。 如果 UntilTimeOfDay 傳回 960，表示 UTC (960/60 = 16：00 (下午 4：00) ，因為 960/60 = 16) 。 若要將此轉換為太平洋時間，您必須減去 480 (= 8 * 60) 分鐘。

您也必須記住，時間會在24小時後變換為零， (亦然;在 1439 第 1439 分鐘之後) 。 如果 傳 UntilTimeOfDay 回 120，則表示 UTC 上午 2：00。 若要將此轉換為太平洋時間，您必須減去 480 分鐘，這會導致 -360。 若要取得具有意義的正值，請將負數加到一天中的總分鐘數 1440，導致最終值為 1080 (下午 6：00) 太平洋時間。

如需有助於調整時區的方法，請參閱 TimeZone、 TimeSpan和 DateTime 。

如果印表機一律可用，則此屬性會在所有時區傳回0。

另請參閱

• TimeZone
• TimeSpan
• DateTime
• StartTimeOfDay
• UntilTimeOfDay
• StartTimeOfDay