PrintSystemJobInfo.StartTimeOfDay Eigenschap

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

public int StartTimeOfDay { get; }

member this.StartTimeOfDay : int

Public ReadOnly Property StartTimeOfDay As Integer

Waarde van eigenschap

Een Int32 opgeven van de vroegst mogelijke begintijd voor de afdruktaak, uitgedrukt als het aantal minuten na middernacht (UTC). De maximumwaarde is 1439.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze eigenschap gebruikt als onderdeel van het proces voor het diagnosticeren van een problematische afdruktaak.

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

Opmerkingen

Deze waarde wordt doorgegeven aan elk PrintSystemJobInfo object vanuit de eigenschap van de PrintQueue.StartTimeOfDay hosting PrintQueue op het moment dat de taak de wachtrij binnenkomt. Als PrintQueue.StartTimeOfDay dit wordt gewijzigd, wordt een PrintSystemJobInfo.StartTimeOfDay waarde die eerder is dan PrintQueue.StartTimeOfDay gewijzigd in de waarde van PrintQueue.StartTimeOfDay.

Nadat de taak is toegevoegd aan de wachtrij, kan deze een nieuwe StartTimeOfDay-waarde krijgen via de Microsoft Windows gebruikersinterface (UI), mits deze niet eerder is dan PrintQueue.StartTimeOfDay.

Als u zich niet in de UTC-tijdzone bevindt, moet u veelvouden van 60 optellen of aftrekken om de juiste tijd voor uw tijdzone te krijgen. Als u zich bijvoorbeeld in de Pacific Time Zone van Noord-Amerika bevindt en zomertijd niet van kracht is, is uw lokale tijd 8 uur eerder dan UTC. Als StartTimeOfDay 960 wordt geretourneerd, betekent dit 16:00 (16:00 uur) in UTC (omdat 960/60 = 16). Als u dit wilt converteren naar Pacific Time, moet u 480 (= 8 * 60) minuten aftrekken.

U moet er ook rekening mee houden dat de tijd na 24 uur overgaat naar nul (dat wil gezegd, na de 1439e minuut). Als StartTimeOfDay 120 wordt geretourneerd, betekent dit 2:00 uur in UTC. Als u dit wilt converteren naar Pacific Time, moet u 480 minuten aftrekken, wat resulteert in -360. Als u een positieve waarde wilt krijgen die betekenis heeft, voegt u het negatieve getal toe aan het totale aantal minuten in een dag, 1440, wat resulteert in een uiteindelijke waarde van 1080 (16:00 pm) Pacific Time.

Zie TimeZone, TimeSpanen DateTime voor methoden die helpen bij het aanpassen van de tijdzone.

Als de printer altijd beschikbaar is, retourneert deze eigenschap 0 in alle tijdzones.

Zie ook

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